XML Swagger 中的评论格式很差 UI
XML Comments Format Poorly in Swagger UI
我正在使用 Swashbuckle 设置 Swagger UI 并让它显示我对我的操作的 XML 评论。
当我这样做时，它们最终看起来非常压扁。这是一个没有评论的例子：
这是带有评论的样子：
有没有办法让 Swagger UI 为操作名称分配更多 space？
<summary> 应该是一个简短的摘要，如 "Create a foo" 或 "Return a foo by ID"。包含使用详细信息的详细说明应转至 <remarks>。 <remarks> 对应 OpenAPI description 字段； Swagger UI 在扩展操作中显示这些描述。这些描述可以使用 Markdown 格式化以进行富文本表示。
/// <summary>
/// Create a foo
/// </summary>
/// <remarks>
/// Lorem ipsum dolor sit amet, consectetur adipiscing elit,
/// sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
/// Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
/// nisi ut aliquip ex ea commodo consequat.
/// </remarks>
我正在使用 Swashbuckle 设置 Swagger UI 并让它显示我对我的操作的 XML 评论。
当我这样做时，它们最终看起来非常压扁。这是一个没有评论的例子：
这是带有评论的样子：
有没有办法让 Swagger UI 为操作名称分配更多 space？
<summary> 应该是一个简短的摘要，如 "Create a foo" 或 "Return a foo by ID"。包含使用详细信息的详细说明应转至 <remarks>。 <remarks> 对应 OpenAPI description 字段； Swagger UI 在扩展操作中显示这些描述。这些描述可以使用 Markdown 格式化以进行富文本表示。
/// <summary>
/// Create a foo
/// </summary>
/// <remarks>
/// Lorem ipsum dolor sit amet, consectetur adipiscing elit,
/// sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.
/// Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris
/// nisi ut aliquip ex ea commodo consequat.
/// </remarks>