ヘルプの組み込み

Eclipse プラットフォームのヘルプ機能は、ドキュメンテーションを構造化してプラットフォームに組み込むための未加工のビルディング・ブロックを提供します。 ドキュメンテーションの構造または細分度は、それによっては決定されません。 ドキュメンテーション用のツールと構造は必要に応じて選択できます。  ヘルプ・プラグインを使用すると、目次 (toc) ファイルを使用してプラットフォームに対するドキュメンテーション構造を記述できます。

プラグインのオンライン・ヘルプは、org.eclipse.help.toc 拡張ポイントを使用して組み込まれます。 オンライン・ヘルプをコードのプラグインのパーツとして追加する、 あるいはオンライン・ヘルプ自体のドキュメンテーション・プラグインでオンライン・ヘルプを個別に提供することができます。

ドキュメンテーションを個別のプラグインに分離すると、 コードとドキュメンテーションのチームが別のグループである場合、 またはドキュメンテーションとコードの結合の度合いを小さくしたい場合に役立ちます。

ヘルプ・システムの拡張フィーチャーには、参照リンク 付きのコンテキストに依存したヘルプ、および ドキュメンテーションからプラットフォーム・コードを 起動する機能が組み込まれています。 ヘルプ・ ブラウザーを使用すると、ドキュメンテーション の表示、印刷、検索が可能になります。3.1 以降では、 新しい「ヘルプ」ビューには、ダイナミック・ヘルプと統合情報検索機能 が追加されます。

ヘルプの contribution について理解する最良の方法は、ドキュメンテーション・プラグインを作成することです。