「テクニカルライティング」とマニュアル作成 -テクニカルライティングで考えたマニュアル作成-3段階のプロセスで考える

<BODY BGCOLOR="#ffffff"> <P><IMG SRC="t1-ttl.gif" ALT="" ALIGN=BOTTOM WIDTH=570 HEIGHT=180><HR><BR></P><H2>2. テクニカルライティングで考えたマニュアル作成<BR></H2><P><HR><BR></P><H1>2-1　3段階のプロセスで考える<BR></H1><P><HR><BR></P><H2><FONT COLOR="#800000">よいマニュアルを作成するために何から始めたらよいのだろうか</FONT><BR></H2><UL> ここからは，テクニカルライティングを導入してマニュアルを作成するにはどのように進めたらよいのかを解説します．ただし，このコーナーは当ホームページのイントロダクションですので考え方と手法の一例を紹介するにとどめます．<BR> <BR> <UL> <LI TYPE=disc>プロセスの各ステップの詳細やここで取り上げた以外の手法は当ホームページの他のコーナーで解説しています．是非そちらをご覧ください．<BR> </UL><BR> どのような仕事も効率よく進めるには正しいプロセスを踏むことが重要になります．マニュアルにおいてもその限りではありません．先に，「マニュアルを作るには読者指向にならなけばならない」と述べました．そこでまず読者にどのように伝えるのかを<FONT COLOR="#008080"><B>企画（構成を検討して目次を作る）</B></FONT>することからスタートします．企画をした上で，<FONT COLOR="#008080"><B>構成（技術情報を読者向けに執筆する）</B></FONT>，さらに<FONT COLOR="#008080"><B>演出（ビジュアル化）</B></FONT>する，全3段階のプロセスで考えるのがよいと思います．<BR> <BR> <UL> <LI TYPE=disc>よくあるマニュアル作りの進め方で，きちんとした企画をせずいきなり執筆を始め不具合があれば後から直すということがあります．時間的なことを考えると執筆に要する時間より企画（内容・構成の検討）に要する時間のほうか格段に短いはずです．これを惜しんだために後の工程でかけなくてよい時間をかけてしまうのは適切とはいえません．<BR> </UL><BR> プロセスの進め方としては<FONT COLOR="#008080"><B>企画（目次を作る）→構成（執筆する）→演出（ビジュアル化する）</B></FONT>の順序ですが，「読者指向になる」という意味では，「最終的にどのように読者の目に触れ理解されるのか」という読者の視点から逆算して，演出（ビジュアル化）を念頭におきながら目次を作り執筆することがポイントです．<BR> <BR> <UL> <LI TYPE=disc>イラストを追加したりページのデザインを工夫したマニュアルをよく見かけます．しかし，その多くには目次や執筆の内容とはあまり無関係に，ただお化粧をしただけのみかけの演出が目に付くことがあります．読者の眼はさほどに甘いものではありません．読者の理解という必然から生まれた演出（ビジュアル化）こそ重要であり，みせかけの演出は製作費の浪費に過ぎません．<BR> </UL></UL><P><HR><BR></P><H2><FONT COLOR="#800000">各ステップで何をなすべきか</FONT><BR></H2><UL> 前項で述べた3段階を整理してみます．この考え方はマニュアルに限らず多くの文書に応用できると思います．<BR> </UL><H3><FONT COLOR="#000080"><B>Step1［企画</B></FONT><FONT COLOR="#800000"><B>（目次作り）</B></FONT><FONT COLOR="#000080"><B>］：技術情報をいかに変換して受け手に伝えるか，その基本的指針を検討・決定する</B></FONT><BR></H3><UL> <UL> <LI TYPE=circle>誰のために，何のためにマニュルを作のか．受け手（読者）のことをまず考えてみましょう．<BR> <LI TYPE=circle>その上で，「目次」として具体的に内容構成を表現してみてください．技術仕様書をそのまま目次にすることは避けるべきです．<BR> </UL></UL><H3><FONT COLOR="#000080"><B>Step2［構成</B></FONT><FONT COLOR="#800000"><B>（執筆）</B></FONT><FONT COLOR="#000080"><B>］：情報を分解し，これを企画方針に基づいて再構築する</B></FONT><BR></H3><UL> <UL> <LI TYPE=circle>ベースとなる技術情報をいったん分解し，目次にそって統合・関連付け，再構築します．<BR> <LI TYPE=circle>正確でわかりやすい文章で表現するためには，「執筆のルール」や「わかりやすい文章を書くためにチェックポイント」を考慮してください．<BR> </UL></UL><H3><FONT COLOR="#000080"><B>Step3［演出</B></FONT><FONT COLOR="#800000"><B>（ビジュアル化）</B></FONT><FONT COLOR="#000080"><B>］：再構築された情報を構造化，イラスト化，さらにレイアウトすることにより視覚的な演出を行う</B></FONT><BR></H3><UL> <UL> <LI TYPE=circle>視覚的な理解を取り入れることを検討しましょう．<BR> </UL></UL><P> <DIV ALIGN=CENTER><IMG SRC="t101fg2.gif" ALT="Fig.T101-2" ALIGN=BOTTOM><BR> 図2 マニュアル作成フロー：それぞれのステップの <B>Key Words</B> については各ステップで説明します<BR></DIV> <HR><BR> <A HREF="t101c2s1.htm" TARGET="_parent"><IMG SRC="nxt.gif" ALT="" ALIGN=BOTTOM></A> <B>次ページに進む（ボタンをクリックしてください）</B><BR> <HR><BR> <IMG SRC="../gif/knrn-lnk.gif" ALT="" WIDTH=140 HEIGHT=35><BR></P><UL> <A HREF="../techwrt-2-1p/t-2-1f.htm" TARGET="_parent"><B>第1部　わかりやすいマニュアルを作るために</B></A><FONT COLOR="#800000"><B>-マニュアル作成の進め方- </B></FONT><BR> </UL><P> <HR><BR> Copyright:Takaaki-YAMANOUCHI/1995-2001<BR> 山之内孝明／(有)山之内総合研究所<BR> Takaaki Yamanouchi/ Yamanouchi Research Institute,Ltd.<BR> <BR></P></BODY>