マニュアル・ドキュメントの効率的な管理・運用・保守

現在、多くの企業では、大量のドキュメント整備や管理が重要な問題となっています。
マニュアルに関する次のようなお悩みはございませんか。

• 欲しい情報・ドキュメントにたどりつけない
• 見出し構成、レイアウト、表記・表現が統一しておらず、マニュアルが読みづらい
• 複数のマニュアルに存在する共通の記載を、うまく流用したい
• マニュアル改訂・更新作業に非常に工数がかかる・・・

その様なお悩みはありませんか？ヒューマンサイエンスではこれらの課題を解決するため、DITA導入支援を行っています。

ヒューマンサイエンスが提供するDITAサービス

ヒューマンサイエンスでは主にリライト、コーディング、翻訳サービスを行っております。
また、パートナー企業様と協業し、CMS開発も行っております。

なぜDITA導入前にリライトするのか？

DITAでは、情報はトピック単位で記述し、さまざまなマニュアルで共有されます。つまり、 同じトピックを複数のマニュアルで使い回し、ムダを省きます。これが「トピックの再利用」です。
では、再利用される文章がわかりにくく、読みづらかったらどうでしょうか。
ヒューマンサイエンスは、DITA導入のメリットが発揮されるよう、効果的なライティングサービスをご提案します。
「何分冊も似たようなマニュアルがある」「多言語翻訳が控えている」などの場合は、特にマニュアルの見直し（事前準備）が重要です。

ヒューマンサイエンスのライティングサービス

1. DITA化前のリライトサービス

DITA導入にあたって、マニュアルの整備はお済みですか？トピック再利用のためには、高品質な文章はかかせません。
まずは次の観点でマニュアルを見直し、文章をブラッシュアップすることを始めましょう。

2. DITA化のためのトピック志向ライティングサービス

DITA関連のサイトでよく登場する「トピックライティング」。そもそも、一般のライティングとDITA化を意識したライティングは、
どこが違うのでしょうか。
ヒューマンサイエンスは、次の３つの意識が大切であると考えます。

すべて「部品」であるという意識をもってライティングする

マニュアルを構成するすべての段落/文章は部品化され、他のマニュアルに再利用されます。
いま書いている文章が、他のマニュアルでも使われることを意識してライティングすることが大切です。
たとえば、指示代名詞「この」「その」などを使って直前の段落の内容に言及したり、前後の文脈がないと意味が理解できない文章はNGです。

すべての段落は「タグ付け」される、という意識をもってライティングする

一般のライティングでは、段落や文章の記載順序や記載位置は、多少あいまいでも許容されます。
一方タグ付けされる場合、すべての段落や文章は意味や目的をはっきりさせなくてはなりません。 コーディング時に、どのタグを付けたらよいか迷わないよう記載位置や順番を十分考えてライティングすることが大切です。

「構造化文書」である、という意識をもってライティングする

一般のライティングでも、執筆規約は存在します。それでも、わかりやすさが優先され、例外処理が許容されることが多くあります。
たとえば、見出しレベルを新たに設けたり、インデントを深くするなどが挙げられます。
DITA向けのライティングの場合、わかりやすさより構造化ルールが優先されます。
ルールに外れた場合、コーディング時に構造化ルールに適した文章に修正しなくてはなりません。
構造化ルールを順守してライティングすることが大切です。

3. マニュアル評価レポートで事前にリライト範囲を確認

どのレベルまで踏み込んだリライトを行うか、マニュアルの癖やリライト範囲を事前にご確認いただけます。

改善ポイント（サンプル例）
「表記ゆれ」「重複表現」「冗長表現」「情報のグルーピング」「手順整理」「不要な指示代名詞」など

関連サービス