Discrepancy in documentation tags descriptions.

[albert-github]

There is a bit of a discrepancy between this chapter "Recommended XML tags for C# documentation comments" (https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/xmldoc/recommended-tags) and the chapter "Annex D Documentation comments" (https://docs.microsoft.com/en-us/dotnet/csharp/language-reference/language-specification/documentation-comments) even when the both chapters might have different intentions.

The discrepancy is that e.g. the tag permission is mentioned in the one part and not in the other. Same for inheritdoc .

Might be worthwhile to merge both chapters so that the is no duplication / discrepancy.

---

Document Details

⚠ Do not edit this section. It is required for docs.microsoft.com ➟ GitHub issue linking.

• ID: 3bcb925f-ef72-9a64-3762-c0b4a96f9dc4
• Version Independent ID: d135d0a6-53d2-1567-0b1b-7aae5e07739f
• Content: Recommended XML documentation tags for a class and its members
• Content Source: docs/csharp/language-reference/xmldoc/recommended-tags.md
• Product: dotnet-csharp
• Technology: csharp-language-reference
• GitHub Login: @BillWagner
• Microsoft Alias: wiwagn

[BillWagner]

Thanks for noting this @albert-github

I'm going to transfer this issue to the csharpstandard repo for the ECMA committee to take on in its work updating the standard.