![]()

いかなる作業も,決めるべき事項を決めてから臨めば効率と品質が向上します.マニュアル作成も同様です.執筆の途中で迷うであろう事項を最小限にするために,文書書式(見出し,図・表などさまざまな書式の総称)と用字用語(文書を作成する際に用いる字と語,例:漢字書きとひらがな書きの使い分け)をあらかじめルール化しておくことを薦めます.
また,マニュアルは一般的な文書書式の規範に基づいている必要があります.変則的にならないように,多くのマニュアルで定着した文書書式を選ぶことを薦めます.
当サイトの「マニュアル作成の進め方」でも述べましたが,「マニュアル執筆キット」とはこれから作成しようとするマニュアルの仕様書ともよべる文書セットです.
「見本ページ(+留意事項)」,「チェック項目」,「執筆要領・用語抜粋」と「見出し構成」で構成されます.
マニュアルを作成する際に選んだ文書書式を「執筆要領」と「見本ページ(+留意事項)」に表しておけば,執筆時の確認にもなりますし 数人で分担して執筆する際に有効です.
同様に「用語抜粋」を用意しておけば,一般用語および専門用語の統一につながります.
ここで留意しておきたいのは,「マニュアル執筆キット」はマニュアルの仕様書に相当する文書セットであって,「これさえあればマニュアルを作成できる」訳ではないという点です.
製品を開発する際と同様です.仕様書があっても技術がなければ仕様を達成できません.マニュアルの作成にあたっても,作成技術に相当する「テクニカルライティングの手法」を導入されることを薦めます.
|
上記の主旨により,当社ではコンサルティングおよびセミナー以外で「マニュアル執筆キット(テンプレート版)」の配布を実施しておりません. |

当社では,少人数から開催可能なテクニカルライティング研修コース(出張開催セミナー)を ご用意しています.出張開催セミナーは,当コーナーの最後でもご案内しています.
当コーナーでは,各種マニュアルの共通基礎からその一部を解説します.また,プレビュー版の主旨から解説の一部を省略する場合があります.

<当コーナーの主旨とご閲覧にあた ってのお願い>
|
当コーナーは,当社のテクニカルライティング研修コース(出張開催セミナー)の抜粋・プレビュー版です.
|
![]()
実践テクニカルライティングセミナー
マニュアル作成の進め方とわかりやすいマニュアルのポイント
Copyright:Takaaki-YAMANOUCHI/2002-2010
山之内孝明/有限会社 山之内総合研究所
Takaaki Yamanouchi/ Yamanouchi Research Institute,Ltd.
takaaki@yamanouchi-yri.com