The C# XML documentation page mentioned that the compiler and Visual Studio validate HTML formatting tags like <b>, <i>, <u>, <br/>, and <a>, but these tags lacked proper documentation sections explaining their usage.

Changes Made

Added comprehensive documentation for 5 HTML formatting tags:

• <b> - for bold text formatting
• <i> - for italic text formatting
• <u> - for underlined text formatting
• <br/> - for line breaks with cross-reference to <para> differences
• <a> - for hyperlinks with href attribute explanation

Added guidance for deprecated tag:

• Note about <tt> being deprecated with recommendation to use <c> instead

Updated table of contents:

• Added proper anchor links for all new sections in the "Format documentation output" section
• Maintained consistent formatting with existing entries

Each new section includes:

• Clear XML syntax examples
• Detailed descriptions of purpose and behavior
• Notes about compiler and Visual Studio validation
• Information about how they appear in IntelliSense and generated documentation

Issue Clarification

The original issue incorrectly stated that <code> documentation was missing - it already had complete documentation at lines 281-290. The actual missing elements were the HTML formatting tags that were mentioned but not documented.

Fixes #18918.

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

Internal previews