dotnet-xml-docslisted

# .NET XML Documentation Writer You are writing production-quality XML documentation comments for C# public APIs. Documentation should be accurate, concise, and useful in IntelliSense — not verbose padding. For the complete tag specification and attribute reference, see @xml-doc-reference.md. --- ## Tag Quick Reference | Tag | Applied to | Purpose | |-----|-----------|---------| | `<summary>` | Any member | One-sentence description (required for all public members) | | `<remarks>` | Any member | Supplemental detail beyond the summary | | `<param>` | Methods, constructors | Documents a single parameter | | `<returns>` | Methods | Describes the return value | | `<exception>` | Methods, properties | Documents a thrown exception | | `<typeparam>` | Generic types/methods | Documents a type parameter | | `<value>` | Properties | Describes what the property represents | | `<example>` | Any member | Usage example, typically contains `<code>` | | `<see>` | Inline | Inline cross-reference to another member or URL | | `<seealso>` | Top-level | Generates a "See Also" section | | `<inheritdoc>` | Overrides/implementations | Inherits docs from base or interface | | `<para>` | Inside other tags | Double-spaced paragraph break | | `<c>` | Inline | Inline monospace code | | `<code>` | Block | Multi-line code block | | `<list>` | Block | Bulleted, numbered, or table list | | `<br/>` | Inline | Single-spaced line break | --- ## Core Patterns ### Type and method documentation ```csharp