説明には一般的に、パラメータに必要な関する情報と、それらがどのように使用されるのか(変更可能なオブジェクトが渡されたときに、変更されるのかどうか)、副作用、投げられる可能性のある例外の情報を含めます。あるデータ構造で表現できます(他のpyドメインのディレクティブでも同様です)。name¶モジュール内のグローバルなデータの説明をします。変数も値も"定義された定数"として取り込むことができます。クラスとオブジェクトの属性はこの環境を使用してドキュメントを書くことはできません。例外クラスの説明をします。シグニチャには、コンストラクタの引数を括弧付きで含めることもできますが、しなくてもかまいません。name(parameters)クラスについて説明します。シグニチャには、丸括弧とともにコンストラクタ引数として提示されるパラメータをオプションで含めることができます。このクラスに属する属性とメソッドのディレクティブはこのディレクティブの本体の中に記述します。このクラスの外に書いた場合は、提供された名前にクラス名が含まれていれば、クロスリファレンスは動作します。Bar.quux()最初の書き方が推奨です。name¶オブジェクトの属性のデータの説明をします。この説明には期待されるデータの型、値を直接変更できるかどうか、という情報を含めます。name(parameters)¶オブジェクトのメソッドの説明をします。パラメータははずします。同じ情報を記述するようにします。一緒ですが、メソッドがスタティックメソッドであるということを表します。一緒ですが、メソッドがクラスメソッドであるということを表します。name(parameters)デコレーターを説明します。このシグニチャにはデコレーターの使い方を記述します。いったロールはありません。ロールを使用してください。同じですが、対象がメソッドになります。Pythonシグニチャ¶Pythonで書くのと同じように、関数、メソッド、クラスコンストラクタのシグニチャを与えることが出来ます。オプション引数のデフォルト値を与えることもできます。値にカンマが含まれると、シグニチャのパーサはうまく動作しません。objectデフォルト値を持たない省略可能なパラメータを持つ関数(よくある例としてはキーワード引数をサポートしていないC拡張モジュールで実装された関数があります)のため、省略可能な部分を角かっこで指定することも出来ます。通常、カンマの前に開き括弧を付けます。