「わかりやすいマニュアル」とテクニカルライティング－マニュアルとテクニカルライティング－

<BODY BGCOLOR="#ffffff"> <P> <img border="0" src="../gif/sec1.gif" alt="マニュアル作成のポイント" width="540" height="26"><BR> <IMG SRC="../gif/tw1.gif" ALT="「わかりやすいマニュアル」とテクニカルライティング" width="570" height="150"><HR><H1> <span style="font-weight: 400"><font color="#800000">マニュアル</font>と<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"> テクニカルライティングには、「<font color="#800000">わかりやすいマニュアル</font>」を具体化するさまざまな手法があります。同時にこれらの手法は、マニュアルを作成する際に執筆者が遭遇するさまざまな課題の解決策でもあります。</p> </td> </tr> </table> </blockquote> </blockquote> <hr> <h2><span style="font-weight: 400"><font color="#800000">「わかりやすい」を具体化</font>する手法</span></h2> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 前述のように、マニュアルのわかりやすさは主に「<font color="#800000">“見通しがよい”見出し構成</font>」、「<font color="#800000">要点が明確な段落</font>」および「<font color="#800000">視覚的・構造的な表現</font>」で構成されています。テクニカルライティングには、これらを具体化するさまざな手法が事例とともに体系化されています。</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="t1-005.jpg" vspace="10" width="432" height="324"></p> <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></p> </li> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080">対して、「並列」構成には強い順序性はなく、それぞれ個別の読んでも差し支えない構成と言えます。</font></p> </li> </ul> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="t1-008.jpg" vspace="5" width="384" height="288"><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></p> </li> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> たとえば、パソコンの図解参考書をご覧になると、章の最初に総論的な節があり、それに続けて各種の操作方法の節を並列に連ねた構成になっています。</font></p> </li> </ul> <p style="line-height: 150%; text-indent: 15; margin: 1 10"> 「第1節　概要（総論）」→「第2節　各種の操作」の直列的な構成にすると、「第2節　各種の操作」の下位に項見出しとして“各種”の操作が並列に構成される結果になります。</p> <ul> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> その結果、「概要」の節が2ページ程度に対し、「操作」の節が数十ページになる場合があります。また、読者にとって「知りたい事項」である操作方法が下位となり、“見通しが悪い”見出し構成になります。</font></p> </li> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> 加えて、「操作」の節では「各種の操作方法があります」あるいは「各種の操作方法を示します」程度のさほど“意味がない”節に陥る場合があります。</font></p> </li> </ul> <p style="line-height: 150%; text-indent: 15; margin: 1 10"> 「直列」構成と「並列」構成を組み合わせて項見出しを節見出しに繰り上げると、読者にとって「知りたい事項」である操作方法が上位となり、“見通しがよい”見出構成になります。</p> <ul> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> 第1節でそれぞれの操作の関係を図解で示すとよりわかりやすくなります。また、サブタイトルなどを用いて見出し名で見出しの関係を補足するのも効果的です。</font></p> </li> </ul> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="t1-009.jpg" hspace="5" vspace="5" width="384" height="288"><img border="1" src="t1-010.jpg" vspace="5" width="384" height="288"><p style="margin:1 10; line-height: 150%; text-indent:15"> テクニカルライティングには、上記以外に複雑な見出し構成をわかりやすくするさまざまな手法があります。また、文章・段落をまとめるあるいは図解化する際に有効な各種の手法があります。<ul> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> 「わかりやすい」とされる文書には、これらの手法が効果的に使われています。「手法」は、あるい意味で「マジック（手品）」と同じです。“種明かし”をしてしまえば、簡単に使えます。けして職業ライターだけの「技」でではありません。</font></p> </li> </ul> <HR> <p> <A HREF="t101c1s2.htm" TARGET="_parent"><IMG SRC="../gif/0000.gif" ALIGN=bottom width="37" height="37"></A> <B>次ページに進む（ボタンをクリックしてください）</B></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>