Internal documentation for contributors and maintainers.
This folder is NOT published to the MkDocs site.
Cross-cutting architecture analysis including data controls, login/identity, theming, and migration toolkit design documents.
HTML output comparison audits between Web Forms and Blazor components. Contains:
blazor/— Captured HTML output from Blazor componentswebforms/— Captured HTML output from original Web Forms controlsnormalized/— Normalized HTML for diff comparisondiff-report*.md— HTML comparison reports
WingtipToys migration benchmark reports measuring transform counts, build attempts, and BWFC control preservation rates.
| File | Description |
|---|---|
Run9-WingtipToys-Benchmark.md |
Cycle 0 baseline (667 transforms, 173 BWFC instances) |
Run10-WingtipToys-Benchmark.md |
Cycle 1 improvements (673 transforms, 172 BWFC instances) |
Run11-WingtipToys-Benchmark.md |
Cycle 2 improvements (178 BWFC instances, 98.9% preservation) |
Per-component analysis and HTML output research (~58 docs). Each document compares the original .NET Framework 4.8 API surface against the Blazor component implementation — covering properties, events, methods, and HTML output.
Status Categories:
| Status | Meaning |
|---|---|
| ✅ Match | Feature exists and works the same as Web Forms |
| Feature exists but is incomplete or behaves differently | |
| 🔴 Missing | Feature does not exist in the Blazor component |
| N/A | Feature is server-side only (ViewState, PostBack, etc.) |
HTML capture files from original Web Forms controls. Used as reference for verifying Blazor component HTML output fidelity.
Test run reports from automated migration testing. Each subfolder contains a report.md with metrics, findings, and recommendations.
| Folder | Date | Notes |
|---|---|---|
wingtiptoys-2026-03-04/ |
2026-03-04 | Initial test run |
wingtiptoys-run2-2026-03-04/ |
2026-03-04 | Second iteration |
wingtiptoys-run3-2026-03-04/ |
2026-03-04 | Third iteration |
wingtiptoys-run4-2026-03-04/ |
2026-03-04 | Fourth iteration |
wingtiptoys-run5-2026-03-04/ |
2026-03-04 | Fifth iteration |
wingtiptoys-run6-2026-03-04/ |
2026-03-04 | Sixth iteration |
Milestone plans, audits, and post-fix reports tracking project progress across development cycles.
Feature proposals and design documents for new functionality.
| File | Description |
|---|---|
p1-p5-custom-controls-framework.md |
P1–P5 Custom Controls drop-in replacement framework — TagKey, enums, DataBound, templates, shims |
Executive reports and migration benchmarks including the WingtipToys migration executive report.
Visual comparison screenshots showing original Web Forms pages vs. migrated Blazor pages. Used in benchmark reports and visual regression testing.
Contents:
original-*.png— Screenshots from the original Web Forms applicationmigrated-*.png— Screenshots from the migrated Blazor applicationcomparison-*.png— Side-by-side comparison images*.html— HTML mockups for visual verification
This folder consolidates all internal development artifacts:
| Folder | Audience | Published? |
|---|---|---|
docs/ |
Library users | ✅ Yes (MkDocs) |
dev-docs/ |
Contributors, team | ❌ No |
samples/ |
Developers (demo) | ❌ No |
migration-toolkit/ |
Migration users | ❌ No (ships with NuGet) |
- User documentation — Published MkDocs site
- Migration toolkit — Standalone migration tooling (end-user distributable)