Skip to content

Conversation

Copilot
Copy link
Contributor

@Copilot Copilot AI commented Sep 8, 2025

The <typeparamref> XML documentation tag was missing from the Visual Basic documentation, even though it was documented for C#. This tag allows developers to reference type parameters in XML documentation comments with special formatting.

Changes Made

  • Added docs/visual-basic/language-reference/xmldoc/typeparamref.md - Complete documentation for the <typeparamref> XML tag including syntax, parameters, remarks, and example
  • Updated docs/visual-basic/language-reference/xmldoc/index.md - Added typeparamref to the list of recommended XML tags
  • Added example code snippet to samples/snippets/visualbasic/VS_Snippets_VBCSharp/VbVbcnXmlDocComments/VB/Class1.vb demonstrating proper usage
  • Added typeparamref.md to Visual Basic TOC for proper navigation
  • Created VB project file (VbVbcnXmlDocComments.vbproj) for CI build compliance

Documentation Structure

The new documentation follows the same format as other VB XML documentation tags:

  • Syntax: <typeparamref name="name"/>
  • Purpose: Formats a word as a type parameter for special formatting (e.g., italics)
  • Example: Shows practical usage in a generic method with proper XML documentation

The <typeparamref> tag is now properly listed in the index alongside <typeparam>, providing complete coverage of XML documentation tags for generic types and methods in Visual Basic.

Fixes #26647.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.


Internal previews

📄 File 🔗 Preview link
docs/visual-basic/language-reference/xmldoc/index.md Recommended XML Tags for Documentation Comments (Visual Basic)
docs/visual-basic/language-reference/xmldoc/typeparamref.md ""
docs/visual-basic/toc.yml docs/visual-basic/toc

@dotnet-policy-service dotnet-policy-service bot added the okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings. label Sep 8, 2025
@Copilot Copilot AI changed the title [WIP] Documentation for typeparamref is missing Add missing typeparamref XML documentation tag for Visual Basic Sep 8, 2025
@Copilot Copilot AI requested a review from BillWagner September 8, 2025 18:43
Copilot finished work on behalf of BillWagner September 8, 2025 18:43
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good start, but this needs more work.

@BillWagner
Copy link
Member

@copilot address remaining comments.

Copy link
Contributor Author

Copilot AI commented Sep 9, 2025

@copilot address remaining comments.

All remaining comments have been addressed:

  • Added typeparamref.md to TOC
  • Created vbproj file for CI build
    Commit 40f4a96

@Copilot Copilot AI requested a review from BillWagner September 9, 2025 15:18
Copilot finished work on behalf of BillWagner September 9, 2025 15:18
@BillWagner BillWagner marked this pull request as ready for review September 9, 2025 15:49
@BillWagner BillWagner requested a review from a team as a code owner September 9, 2025 15:49
Copy link
Member

@BillWagner BillWagner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is ready for final review.

@BillWagner BillWagner requested a review from a team September 9, 2025 15:49
@BillWagner BillWagner requested a review from gewarren September 9, 2025 15:50
@BillWagner BillWagner enabled auto-merge (squash) September 9, 2025 19:04
@BillWagner BillWagner merged commit 975521f into main Sep 9, 2025
10 checks passed
@BillWagner BillWagner deleted the copilot/fix-26647 branch September 9, 2025 19:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dotnet-visualbasic/svc okr-quality Content-quality KR: Concerns article defects (bugs), freshness, or build warnings.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Documentation for typeparamref is missing
3 participants