视觉工作室 2017：<list> 悬停时未正确显示（xml 文档）

Question

如果您将鼠标悬停在 VS17 (15.6.2) 中具有 xml 文档（ ///<summary></summary> ）的某些内容（类、方法等）上，您会看到这个小弹出窗口，其中显示了正确格式化的注释。

我试图列出一个清单（从这里复制）：

/// <summary>Here is an example of a bulleted list:
/// <list type="bullet">
/// <item>
/// <description>Item 1.</description>
/// </item>
/// <item>
/// <description>Item 2.</description>
/// </item>
/// </list>
/// </summary>

但是弹出窗口只在一行中显示它：

Here is an example of a bulleted list: Item 1. Item 2.

我也尝试将<term>添加到它（如这里），但我得到的是：

我也尝试过其他type （也没有），但没有改变。 这是一个错误吗？ 我如何解决它？

Answer 1

这是我的解决方法：

/// <summary>Here is an example of a bulleted list:
/// <list type="bullet">
/// <item>
/// <description><para>&#x02022; Item 1.</para></description>
/// </item>
/// <item>
/// <description><para>&#x02022; Item 2.</para></description>
/// </item>
/// </list>
/// </summary>