源代码文档工具答案

【问题标题】：Source Code Documentation tool源代码文档工具
【发布时间】：2011-05-31 11:24:56
【问题描述】：

谁能推荐一个 VB.NET 10 的源代码文档工具？

谢谢。

【问题讨论】：

标签： .net vb.net documentation-generation

【解决方案1】：

使用开源 Sandcastle 记录 .net 代码

【讨论】：

【解决方案2】：

GhostDoc 是我使用的。很棒的工具。

【讨论】：

谢谢，但我需要一个开源工具用于商业用途。
@Mselmi：抱歉，您没有在问题中说明这一点。

【解决方案3】：

如果您希望您的文档包含除签名中已经显而易见的内容之外的任何内容，那么这里唯一有用的工具是... 您。那和一些/// (C#) 或''' (VB) 很有趣。有工具可以生成诸如“获取或设置 FrobCount”之类的东西，但最终......您认为FrobCount {get;set;} 属性做了什么？

顺便说一句，我不是的意思是“不要费心添加那些 cmets” - 他们确实有一些意义......但我担心的是你养成只是使用自动工具的习惯。最终，这增加了很少的额外价值。该值来自有关语义、预期用法、副作用等方面的知识。没有自动化工具会生成这些。

【讨论】：

【解决方案4】：

我们使用DocumentX。

【讨论】：