我一直在问自己一个问题:"Javadoc、Doxygen等等……微软真的有可能不为它的开发者提供一个好的文档生成器吗?“对我来说这听起来一直很奇怪。也因为Msdn是一个非常好的文档排版工具……在所有其他生成器和文档样式中,我真的更喜欢它。
一直困扰着自己,我最终决定深入研究这个问题,发现了NDoc和SandCastle的存在。哇,我告诉自己,我终于明白了。看起来是这样的。好吧,他们是很好的生成器,但我认为微软赞助了一个官方的文档生成,比我之前提到的两个要多一点。
那么,我想要什么?只需要知道microsoft开发人员使用什么doc-gen来以类似于msdn的方式记录他的代码。我的微软是否认可NDoc或沙堡官方的MSDN式文档生成器?哪一个是最好的?如果不是,我应该使用什么doc-gen来记录msdn样式的文档?
发布于 2010-12-19 05:34:54
SandCastle (带有图形用户界面)是一个完全足够的文档生成器。我看不出为什么微软会花更多的精力在这上面。
顺便说一句,您可能希望获得GhostDoc Visual Studio插件。它大大加快了文档注释的创建速度(它甚至可以完整地生成它们,只要您正确地命名方法和参数等)。
发布于 2011-02-19 00:00:30
我们使用DocumentX (曾经使用NDoc),我非常喜欢它。他们的许可证检查系统有点痛苦,但程序本身是伟大的。
发布于 2010-12-19 05:35:02
尽管最初的NDoc项目在几年前就停止了,但还有一个后续项目:NDoc3
https://stackoverflow.com/questions/4480097
复制相似问题