沙堡或NDoc？一個很好的msdn文檔生成器？

Question

我一直在困擾自己一個問題：「Javadoc，Doxygen等等......微軟是否真的有可能不向開發者提供一個好的文檔生成器？」。對我來說，這一直聽起來很奇怪...另外，因爲Msdn是一個非常好的文檔排版...我更喜歡它高於所有其他生成器和文檔樣式。

不斷打擾自己我終於決定深入研究這個問題，並發現NDoc和SandCastle的存在。哇，我告訴自己，我終於明白了......看起來似乎。好吧，他們是很好的發電機，但我認爲微軟贊助的官方文件比我之前提到的那兩個稍微多一些。

那麼，我想要什麼？只要知道微軟開發人員用什麼doc-gen來以類似msdn的方式記錄他的代碼即可。 NDoc或Sand Castle官方msdn-like文件生成器，批准了我的微軟？ 哪一個是最好的？ 如果它們不是，我應該使用什麼doc-gen以msdn樣式文檔？

Answer 1

SandCastle（帶GUI）是完全足夠的文檔生成器。我沒有看到MS爲什麼會投入更多精力。

順便說一下，您可能想要獲得GhostDoc Visual Studio插件。它加快了文檔評論的創建速度（甚至可以完全生成它們，只要你正確地命名你的方法和參數）。

Answer 2

即使原始NDoc的項目是在幾年前停了下來，有一個後續項目：NDoc3

Answer 3

我們使用DocumentX（用於使用NDoc的），我喜歡它了。他們的許可證檢查系統有點痛苦，但程序本身很好。