マニュアル作成の進め方－分担して執筆する際のポイント－

<BODY BGCOLOR="#ffffff" LINK="#ffffff" ALINK="#ebc83d" VLINK="#ffffff"> <P> <img border="0" src="../gif/sec1.gif" alt="マニュアル作成のポイント" width="540" height="26"><br> <IMG SRC="../gif/tw2-1.gif" ALT="マニュアル作成の進め方" width="570" height="150"><hr><H1> <span style="font-weight: 400"><font color="#800000">分担して執筆する</font>際のポイント</span></H1> <blockquote> <blockquote> <table border="0" cellspacing="0" width="75%" style="border-collapse: collapse" bordercolor="#111111" cellpadding="0"> <tr> <td width="10" bordercolor="#000000" bgcolor="#008080" bordercolorlight="#FFFFFF" bordercolordark="#FFFFFF">　</td> <td bordercolor="#000000" bgcolor="#FFFFFF" bordercolorlight="#FFFFFF" bordercolordark="#FFFFFF"> <p style="margin:1 10; line-height: 150%; text-indent:15"> ページ数が多いマニュアルを作成する際は、分担して執筆するのが一般的です。ところが、執筆者によって書き方がまちまちとなったり内容が偏ったりする場合があります。中核（まとめ役）となる執筆者と分担する執筆者ともにテクニカルライティングの知識と手法を共有して臨むのが、分担して執筆する際のポイントです。</p> </td> </tr> </table> </blockquote> </blockquote> <hr> <h2><span style="font-weight: 400">陥りやすい事例<font color="#000080">－「準備不足型」と「ルール優先型」－</font></span></h2> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 大雑把な見出し構成（章ランク程度）と流用したサンプルだけでマニュアル作成を進めると、表現あるいは内容に不統一が生じます。また、流用のサンプルだけではどのように表したらよいのかわからない箇所が必ず出てきます。その結果、迷って執筆が停滞したり、無理がある見出し構成に陥る場合があります。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> たとえ、“模範”となるようなサンプルがあっても、わかりやすさがどのような手法で実現されているのか理解できなくては応用できません。</font></li> </ul> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 誰かがまとめ役になって詳細な見出し構成と執筆ルールを作ってもうまく進まない場合があります。分担する執筆者に執筆するための知識と手法がなければ執筆ルールがかえって制約となるおそれがあります。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> ごく簡単なマニュアルならばともかく、わかりやすいマニュアルを作成するのに必要な手法をすべてルール化（あるいは“マニュアル”化）するのは無理があります。ルール化できるのは仕様書の範囲にすぎません。</font></li> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> 「しなければならないこと／してはならないこと」に加えて各文章の書き方のレベルまでルール化しようとすると、ケース例あるいは例外が多すぎて収拾がつかなくなります。</font></li> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> マニュアルを作成するための簡単なマニュアルを作ったとしても、さまざまな条件への対応が必要なマニュアルの作成に役立つとは思えません。同じ部署にいる人の行動マニュアルを作るのには使えるかもしれませんが、執筆者と読者が出会わないような製品マニュアルのレベルでは安易なアプローチは避けるべきです。</font></li> </ul> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="t2-013.jpg" vspace="10" width="432" height="324"><hr> <h2><span style="font-weight: 400">テクニカルライティングの知識と手法の<font color="#800000">共有</font></span></h2> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 望ましいのは、「中核になる数名の執筆者」と「分担する執筆者」がでテクニカルライティングの基礎を共有している執筆体制です。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> 中核となる執筆者は先に述べた「マニュアル執筆キット（見出し構成を含む）」を作成・管理します。</font></li> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080">場合によっては、見出し構成も分担して検討し、中核となる執筆者が調整する方法も有効です。</font></li> </ul> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 分担する執筆者がテクニカルライティングの知識と手法を共有していれば、見本ページと執筆要領に沿ってそれぞれの分担を工夫を加えながら執筆できます。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> 分担する執筆者で解決できない事項があれば、中核となる執筆者に相談できます。</font></li> </ul> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 知識と手法を共有した執筆者がかかわれば執筆の効率化にもつながります。また、ノウハウが蓄積・継承され移動などによってメンバーが交代して執筆力が低下しません。</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> けしておおげさな専門部署を作るべきという提案ではありません。マニュアルも商品の一部です。これを作成する「技術」をそれぞれが有していれば、企業の力にもなります。</font></li> </ul> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="t2-014.jpg" vspace="10" width="432" height="324"><HR> <p><a TARGET="_parent" href="t-2-1abs99f.htm"> <IMG SRC="../gif/0000.gif" ALIGN=bottom width="37" height="37"></a> <B>次ページに進む</B><FONT COLOR="#008080"><B>（ボタンをクリックしてください）</B></FONT></p> <HR> <DIV ALIGN=CENTER> <p style="margin:1 10; line-height:150%; text-indent:15"> <img border="0" src="../gif/trp-000.gif" alt="山之内総合研究所の出張開催セミナー" width="300" height="20"></DIV> <DIV ALIGN=CENTER> <p style="margin:1 10; "> <a target="_parent" href="../t6-1st/gb-smnr-1st.htm"> <img border="0" src="../gif/trp-1st-a.gif" hspace="2" vspace="2" width="282" height="24"></a><a target="_parent" href="../t6/gb-smnr.htm"><img border="0" src="../gif/trp-gb-a.gif" hspace="2" vspace="2" width="282" height="24"></a></DIV> <DIV ALIGN=CENTER> <p style="margin:1 10; "> <a target="_parent" href="../t7/mn-smnr.htm"> <img border="0" src="../gif/trp-mn-a.gif" hspace="2" vspace="2" width="282" height="24"></a><a target="_parent" href="../t5a/tp-smnr.htm"><img border="0" src="../gif/trp-tp-a.gif" hspace="2" vspace="2" width="282" height="24"></a></DIV> <DIV ALIGN=CENTER> <p style="margin:1 10; "> <a TARGET="_parent" href="../t-smnr-faq/faq-101f.htm"> <IMG SRC="../gif/tsub-faq.gif" ALT="セミナー／コンサルティングFAQ" ALIGN=bottom BORDER=0 hspace="2" vspace="2" width="282" height="24"></a><a TARGET="_blank" href="../t-smnr-trf/smnr-trf02.pdf"><IMG SRC="../gif/tsub-trf.gif" ALT="セミナー基本料金［抜粋PDF版］" ALIGN=bottom BORDER=0 hspace="2" vspace="2" width="282" height="24"></a></DIV> <hr> <p align="center" style="margin-top: 0; margin-bottom: 0"><A HREF="../../index.htm" TARGET="_parent"> <IMG SRC="../gif/modoru.gif" ALT="" ALIGN=BOTTOM width="180" height="50"></A></p> <hr> <p> <font color="#000066"><b>実践テクニカルライティングセミナー</b></font><font color="#008000"><BR> </font> <b>マニュアル作成の進め方とわかりやすいマニュアルのポイント</b><BR> Copyright:Takaaki-YAMANOUCHI/2002-2010<BR> 山之内孝明／有限会社　山之内総合研究所<BR> Takaaki Yamanouchi/ Yamanouchi Research Institute,Ltd.<BR> <IMG SRC="../gif/email.gif" ALT="" ALIGN=BOTTOM width="23" height="13"><FONT SIZE=4 COLOR="#000080">　</FONT><A HREF="mailto:takaaki@yamanouchi-yri.com"><FONT SIZE=4 COLOR="#000080">takaaki@yamanouchi-yri.com</FONT></A></p> </BODY>