问题描述
|
谁能推荐VB.NET 10的源代码文档工具?
谢谢。
解决方法
使用开源Sandcastle编写.net代码的文档
, 我用的是GhostDoc。很棒的工具。
, 如果您希望文档中包含除签名中已经显而易见的内容以外的所有内容,那么这里唯一有用的工具就是...您。那和一些
///
(C#)或\'\'\'
(VB)的乐趣。
有些工具会生成诸如“获取或设置FrobCount \”之类的东西,但是最终……您认为FrobCount {get;set;}
属性的作用是什么?
顺便说一句,这并不是说“不要烦恼添加这些注释”,它们确实具有某种意义……但是我担心的是,您养成了只使用自动工具的习惯。最终,这几乎没有增加额外的价值。其价值来自语义,预期用法,副作用等方面的知识。没有自动化的工具可以生成这些信息。
, 我们使用DocumentX。