Dは言語にモダンなソフトウェアエンジニアリングの重要なパーツを統合することを試みます。 契約プログラミングやユニットテスト以外にDはソースコードの外にネイティブに ドキュメントを生成します。
型や関数をドキュメント化するための標準スキーマであるコマンドdmd -D
を使うことで便利にコマンドラインでソースファイルをもとにした
HTMLドキュメントを生成します。
実際、Phobosライブラリドキュメント
のすべてはDDocで生成されています。
下記のコメントスタイルはソースコードのドキュメントに含まれるものとDDocにみなされます:
/// 型もしくは関数の前の3つのスラッシュ
/++ 2つの + で複数行コメント +/
/** 2つの * で複数行コメント */
標準化されたドキュメントセクションについての詳細はソースコードサンプルを見てください。