...}//#controller外部ファイルにコードサンプルを抽出することの要点は、ドキュメント中のすべてのコードがコンパイルされ、テストされていることなので、これらのディレクティブは最後の手段として使わなければなりません。ディレクティブはこの要点に違反します。文が記述されていることを保証するために、コードサンプルの現在のコンテキストに注意することも重要です。文をすべて含める必要はないので、ここでは慎重さが示される必要があります。特別な種類のコードサンプルに向けたガイドラインを以下に示します。適切な場所におけるローカルクラスおよびメソッド定義を推奨します。使ってテストする必要があります。テストの中に含めることができますが、コードサンプルがメソッドまたはクラスの場合、より難しくなります。ローカルなインナークラスを使う選択が見受けられるかもしれませんが、これが不可能な場合もあるかもしれません。追加することを意味します。コードサンプルをそのファイル自身に抽出する必要があるかもしれません。いずれかでテストする必要があります。ドキュメントのどちらに含まれるかによって、異なるデフォルトのインポートでコンパイルされることに注意してください。このため、正しいコンテキストにおいてテンプレートをテストすることも重要です。アクションからテストされるべきです。可能であれば、テンプレートコードサンプルはひとつのファイルに統合されるべきですが、例えばコードサンプルが引数宣言を含む場合など、常に可能であるとは限らないでしょう。いずれかでテストする必要があります。ように完全なパッケージ名を含めた名前にしなければなりません。コンパイラは、そのドキュメントに宣言された名前空間内でリバースルータを生成する特別なモードで動作します。コードサンプルは絶対パスを使ってクラスを参照しているように見えるにも関わらず、実際にはルーターの名前空間に対する相対パスを使うということを意味します。いうコントローラへの参照になります。コードサンプルをドキュメントの外に抽出することはできません。§その他のコードその他のコードはテストできないかもしれません。コードをテストすることは理にかなっているかもしれません。実際にロードすることで設定ファイルをテストすることも意味があるでしょう。ここでは常識が用いられるべきです。