Wrong XML in the example or misleading description of <param> tag

[oldGlobula]

The tag is used to describe parameters. If such a tag is used, the documentation generator must verify that the specified parameter exists and that all parameters are described in documentation comments. If such verification fails, the documentation generator issues a warning.

This comment and D.3.9. example made me think that name attribute in <param> tag are mandatory, however, in D.5. section <param> tags do not have name attribute

---

Document Details

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

• ID: db74e905-523c-dae9-f741-af5e52785a9c
• Version Independent ID: c9b7c7a1-0584-b6e6-95cd-5276788fdda0
• Content: Documentation comments - C# language specification
• Content Source: standard/documentation-comments.md
• Product: dotnet-csharp
• Technology: csharp-spec
• GitHub Login: @dotnet-bot
• Microsoft Alias: wiwagn

---

Associated WorkItem - 178987

[BillWagner]

@jskeet

The sample in D.5 should change. It should include the name attribute on the param element.

You can assign this to me and set the C# 8 milestone. It shouldn't slow down the C# 7 standardization, but it's a rather easy fix.