新機能のパッチにの採用につきましては、ドキュメントを用意していただくことが必須要件です。ドキュメントはasciidocの8.xまたは以降のバージョンで書かれています。これらはmake docでコンパイルして、ディレクトリ src/locale/en-US/ に置いてあります。上記についての詳細はasciidoc documentationを参照してください。たいていの場合、テキストをそのまま記述すれば正確に解釈されるでしょう。倒なのは :helpコマンドのための特別なセクションを書くときだけです。

|<F1>| |:help| |:h| |help|
||:h[elp] {subject}|| +
||<F1>||
____________________________________________________________________________
ヘルプ・ウィンドウを開きます。
{subject}を指定しない場合は、デフォルトのセクションが表示されます。
特定のトピックについてヘルプが必要なときは、コマンド [c]:help overview[c] を
ためしてみてください。
____________________________________________________________________________

上記は下記のように表示されます：

<F1> :help :h help

上記のコードについての諸注意。

• |<F1>| はタグを定義します。タグはマゼンタで右側に記述されており、コマンド |<F1>| によってトピックにジャンプするようになっています。右から左へ書かなければならないことに注意してください。上の例では|help| を一番左に、|<F1>|を一番右側に書く必要があります。

• ||:h[elp] {subject}|| + と ||<F1>|| はコマンドまたはマッピング名を定義し、左側に出力しています。コマンドの最後の + は改行を表しています。改行すべきかどうかを決めるルールは設けていませんので、出力結果を見て判断してください。

• このコマンドのための実際のヘルプ・コードには、少なくても４つのアンダー・スコア（ _ ）が組み込まれています。これらはコマンドに属しているということを明確にするために、引用ブロックとテキスト・インデントを生成します。

• [c] で囲むと :command のように描画されます。[o]と[m]はそれぞれオプションとマッピングを示します。

• {…} や [arg]、 [url]、 [count] 、[!] で挟まれた文字列は自動的に青に色付けされます。

また、Vimperatorのためのドキュメント用に、asciidocのコマンドを追加しています。

• コマンド section:Writing{nbsp}Documentation[writing-docs,documentation] は２つのタグを使うことによって、このヘルプ・ファイルの冒頭ドキュメントを書くのように新しいセクションを作ります。

• コマンド help:developer{nbsp}information[developer.html#documentation] はテキストdeveloper informationを、ファイルdeveloper.htmlのタグ・ドキュメンとしてリンクさせます。

作成したドキュメントをファイルあるいはセクションのどこに置けばいいのか分からないときは、メーリング・リストまたは#vimperator（IRCのチャンネル）にてお問い合わせください。通常、ヘルプ・ドキュメントは、'ウェブ・ページを開く'のように、論理的に結びついたサブジェクトごとにグループ化されます。