ソースコードからだけでなく、ドキュメントを作ることができるC＃のドキュメントツール

Question

xmlコメントなどをソースコードに入れたくありません。

は、私はこのような何かやりたい： - 型名

クリックaddメソッド -

1. [追加]をクリックしますクラス型の名前
2. タイプの説明、インポート画像などを

Answer 1

サンドキャッスルXMLコードからヘルプファイルのような素晴らしいmsdnを作成します。

Tutorial

更新

私は私のmissleadingの答えのために申し訳ありません。 Adobe Robocopを試すことができます。アニメーションgifを使用しても高品質のchmファイルを作成するために使用しました。

Answer 2

あなたはC＃のXMLコメントがコンパイラによってサポートされていることを知っています。出力はこのXMLであり、単なるXMLです。

リフレクションを使用して簡単なツールを構築できます。リフレクションと.NETタイプのシステムについてもっと学ぶのは良い練習です。

ソースコードとドキュメントを1か所に置いておくと、DRY principleに準拠しやすくなるので、私は実際にそれに対して助言します。あなたのドキュメントとソースコードがばらばらにならず、いつでもコメントを崩すことができます（ソースコードの編集時には表示されません）。そして、ドキュメンテーションはソース管理下に置かれます。