Generates consistent documentation for BlazorWebFormsComponents following the standard section order: features, unsupported features, declarative syntax, Blazor syntax, HTML output, and migration notes. Handles category assignment and admonition conventions. Use when writing docs for a new BWFC component, documenting migration steps from ASP.NET Web Forms, or creating component reference pages for the documentation site.
When writing documentation for a new BlazorWebFormsComponents component. Apply this pattern to create consistent, migration-friendly documentation.
Every component doc follows this exact section order:
# ComponentName) — Bold intro sentence describing what it does, why it exists in the libraryOriginal Microsoft documentation: https://docs.microsoft.com/en-us/dotnet/api/system.web.ui.webcontrols.{name}?view=netframework-4.8<asp:Component> syntax block showing all attributes### Heading for each usage pattern, each with a razor code blockrazor for Blazor code blocks, html for Web Forms/HTML, csharp for C# code-behind!!! note, !!! warning, !!! tip) for gotchas, security notes, and best practices@code { } block in Blazor examples when event handlers or binding is involved| Property | Type | Description | formatmkdocs.yml are alphabetical within category| Category | Examples | Criteria |
|---|---|---|
| Editor Controls | Button, TextBox, CheckBox, Image, FileUpload, Calendar | Form inputs, display controls |
| Data Controls | GridView, Repeater, ListView | Data-bound controls |
| Validation Controls | RequiredFieldValidator, CompareValidator | Input validation |
| Navigation Controls | HyperLink, Menu, TreeView, ImageMap | Controls that navigate users |
| Login Controls | Login, LoginName, LoginStatus | Authentication UI |
| Utility Features | ViewState, PageService, Databinder | Non-visual services and helpers |