自动生成代码文档是否有逻辑上的原因？[关闭]
可以使用多种工具来自动生成文档，其中GhostDoc是其中最著名的一种。但是，根据定义，它生成的所有内容都是多余的。它查看方法，类等的名称，并输出可能更详细地解释它们的英语。在最好的情况下，它可以完成读者头脑中已经可以做的事情（示例取自此处）： /// <summary> /// Initializes a new instance of the <see cref="Person"/> class. /// </summary> public Person() ... 在最坏的情况下，它最终可能会生成奇怪的文档，而这些文档实际上在试图启发性地弄清名称的含义时具有误导性： /// <summary> /// Riches the text selection changed. /// </summary> /// <param name="richTextBox">The rich text box.</param> private void RichTextSelection_Changed(System.Windows.Controls.RichTextBox richTextBox) ... 似乎对GhostDoc的态度是，“本质上来说，拥有某种形式的 XML文档会更好”，但是当该文档100％冗余时，为什么呢？充其量只是在浪费大量的空间吗？ 在我的工作场所，我们几乎必须始终使用GhostDoc的自动生成的文档来记录所有内容。您这样做是不是有合理的理由，如果您不想自己亲自编写文档，则不要简单地将代码保留在文档之外？