サンドキャッスルまたはNDoc？良いmsdnのようなdocジェネレータ？

Question

私はいつも「Javadoc、Doxygen、そしてはるかに、マイクロソフトが開発者に良い文書生成プログラムを提供していない可能性はありますか？それはいつも私には奇妙に聞こえてきました...また、Msdnは非常に良い文書組版であるので...私は他のすべてのジェネレータや文書スタイルよりもそれを本当に好んでいます。

私はついにこの問題を深く考えることにしました。NDocとSandCastleの存在が分かりました。うわー、私は自分自身に言った、私はついにそれを得る...それはそうだった。確かに彼らは良いジェネレータですが、私はMicrosoftが以前に言及した2つ以上の公式のdoc genを後援したと思っていました。

だから私は何をしたいですか？マイクロソフトの開発者がmsdnのようなスタイルで自分のコードを文書化するために使用するdoc-genを知っているだけです。 NDocまたはSand Castleの公式のmsdn形式のドキュメントジェネレータは、Microsoftの認可を受けていますか？ どちらが最適ですか？ そうでない場合は、どのdoc-genをmsdn形式で文書化する必要がありますか？

Answer 1

SandCastle（GUI付き）は、十分に適切なドキュメントジェネレータです。私はMSがそれにもっと努力する理由は見ません。

ところで、GhostDoc Visual Studioプラグインを入手したい場合があります。ドキュメンテーションコメントの作成を高速化します（メソッドやパラメータに適切な名前を付けていれば、完全に生成することさえできます）。

Answer 2

オリジナルたNdocプロジェクトは数年前に停止したにもかかわらず、後継プロジェクトがあります：NDoc3

Answer 3

我々はDocumentX（たNdocを使用するために使用される）を使用し、私はそれをたくさん好きです。彼らのライセンスチェックシステムは苦痛ですが、プログラム自体は素晴らしいです。