课程文档建议

Question

我们是一家微软商店,专注于使用C#.我们有几个项目,包括网站,Windows服务和类库,它们包含XML注释.

我希望为每个项目生成MSDN样式的HTML文档,并将其部署到一个所有开发人员都可以轻松访问的集中位置.我还希望自动化这些步骤,以便它们可以定期运行,因此我和其他开发人员无需担心在进行更改时记住生成和部署新文档.我看过Sandcastle和Doxygen,它们看起来都是生成我想要的文档的好选择,但是我需要一个很好的方法来自动生成它,比如夜间工作或其他什么.

有人这样做吗？我不是最终结果是HTML出售; 特别是如果有更好的主意.

编辑:

我很欣赏所有好主意.现在我可以调查一些路线了,但是直到弄脏我才知道哪条路线效果最好.Sandcastle帮助文件生成器似乎为我提供了我想要做的最佳选择,所以我会对这个建议表示赞同.但是,如果我有更多时间研究XSLT和CSS解决方案以使XML数据看起来恰到好处,那么我首先会追求这个建议.

再次感谢大家!

Answer 1

查看Sandcastle 帮助文件生成器。这使用独立项目，因此您可以根据需要经常构建它们（例如每晚，或者每次签入更改时作为持续集成系统的一部分）。