Skip to content

Commit 980963a

Browse files
authored
Fix for 41486 (dotnet#41861)
1 parent e1109cc commit 980963a

File tree

1 file changed

+11
-1
lines changed

1 file changed

+11
-1
lines changed

docs/csharp/language-reference/xmldoc/recommended-tags.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -256,7 +256,17 @@ The `<para>` tag is for use inside a tag, such as [\<summary>](#summary), [\<rem
256256
</list>
257257
```
258258

259-
The `<listheader>` block is used to define the heading row of either a table or definition list. When defining a table, you only need to supply an entry for `term` in the heading. Each item in the list is specified with an `<item>` block. When creating a definition list, you'll need to specify both `term` and `description`. However, for a table, bulleted list, or numbered list, you only need to supply an entry for `description`. A list or table can have as many `<item>` blocks as needed.
259+
The `<listheader>` block is used to define the heading row of either a table or definition list.
260+
261+
When defining a table:
262+
* You only need to supply an entry for `term` in the heading.
263+
* Each item in the list is specified with an `<item>` block. For each `item`, you will only need to supply an entry for `description`.
264+
265+
When creating a definition list:
266+
* You must supply an entry for `term` in the heading.
267+
* Each item in the list is specified with an `<item>` block. Each `item` must contain both a `term` and `description`.
268+
269+
A list or table can have as many `<item>` blocks as needed.
260270

261271
### \<c>
262272

0 commit comments

Comments
 (0)