c# - Visual Studio 2017 : not showing correctly on hover (xml documentation)

Question

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

/// <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>到它(如 here )但我得到的是:

我试过另一个 type s 也是(也没有)但没有变化。这是一个错误吗？我如何解决它？

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>