DITAによるドキュメンテーション

DITAの概要と普及の背景

DITAは、Darwin Information Typing Architectureの略で、製造業やソフトウェア業界におけるマニュアルやトリセツ（取扱説明書）をはじめとする技術情報を効率良く制作・管理・配信・再利用するために策定されたXMLベースのアーキテクチャであり、文書の構造化が意識された技術です。

特に、グローバルに展開する大手製造業では、マニュアルにかけることが出来る予算も大きい傾向にあり、DITAを採用する企業が存在します。その理由は、自動車やパソコン、プリンタ、エレクトロニクス製品など消費者向け製品から、建機、工作機械、産業機械、通信機器やソフトウェアなど企業向け製品まで、製品のライフサイクルの短縮化やグローバル化の進展、さらには安全基準や規制の適用厳格化により、製品のトリセツ（取扱説明書）や保守点検マニュアルといった構造化ドキュメントの重要性が高まってきたためです。DITAによるドキュメンテーションは、以下のようなマニュアルやトリセツ（取扱説明書）を編集・管理する上での課題を解決します。

• 編集時に同じ内容を何度もライティング（コピペ）する必要がある。
• ファイル単位の版数管理になってしまう。
• 改訂時に、差し替え箇所が特定できず、差し替えミスが発生する。
• ファイル単位で翻訳するため、翻訳コストと翻訳管理コストが増大する。
• 編集者と校正者でドキュメントの共有がしにくいため校正作業が非効率。
• ドキュメントの量が増えると検索が遅くなり、欲しい情報が手に入らない。
• 紙のマニュアル専用のデータのため、HTMLによる電子マニュアルは一から作り直さなければいけない。

DITAは、このような技術ドキュメントの課題を解決するための手法としてアメリカで提唱、規格化され、大手航空機会社の保守マニュアル等、複雑な手順の記載が必要な膨大なドキュメントで実績をあげています。日本でも工作機械メーカー、家電メーカー、半導体メーカー、産業機械メーカーなどがDITAの導入を検討し、まだ局所的ですが一部活用されています。しかしながら、日本語でのライティングスタイルに合わないといった課題や、技術的に習得すべき様々な事が必要となるため、日本国内では広く普及するには程遠い現状です。

DITAの技術と仕様

DITAは、2017年9月現在、Version1.3がリリースされています。日本国内のDITAの普及啓蒙は、DITAコンソーシアムジャパンが中心となって活動を行っています。このようにベンダーだけでなくユーザ企業も含めた活動により、DITA導入や運用のノウハウの蓄積が進み、導入事例の公開も少しずつ増加しています。

DITAは、XMLをベースにしたアーキテクチャであり、トピック（情報の内容）とマップ（情報の構造）という2種類のデータで構成されています。トピックはその目的別に「コンセプト型トピック」「タスク型トピック」「リファレンス型トピック」「グロッサリー型トピック」の4種類に分類されます。「コンセプト型トピック」は、製品の説明文等を記述する際に使用します。「タスク型トピック」は、取り付け手順や作業手順、工程などを記述する際に使用します。「リファレンス型トピック」は、別のトピックへ参照する際に使用します。「グロッサリー型トピック」は、用語集を作成する際に使用します。

基本的には、DITAを使ってマニュアル（取扱説明書）や技術文書を作成する場合は、上記いずれかのトピックタイプに当てはめていけば良いのですが、DITAは、「特殊化」という概念で、これらを派生させて個別のトピックタイプを記述することを可能にしています。