「わかりやすいマニュアル」とテクニカルライティング－見出し構成の考え方と段落のまとめ方－

<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"> マニュアルに限らず、技術文書は「見出し」と「段落」で構成されていると言えます。具体的な見出し名を受け、段落の最初で要点を示すのが技術文書の基本です。</p> </td> </tr> </table> </blockquote> </blockquote> <hr> <h2><span style="font-weight: 400"><font color="#800000">見出し構成</font>と<font color="#800000">見出し名</font>の考え方</span></h2> <p style="LINE-HEIGHT: 150%; TEXT-INDENT: 15px; MARGIN: 1px 10px">先に述べたように、マニュアルでは<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="../techwrt-2-3p/1001.jpg" hspace="2" vspace="5" width="384" height="288"><img border="1" src="../techwrt-2-3p/1003.jpg" hspace="2" vspace="5" width="384" height="288"><p> <IMG SRC="../gif/knrn-lnk.gif" ALT="" width="140" height="35"><span style="font-weight: 400"><FONT COLOR="#006600" size="4">第1部</FONT></span>　<span style="font-weight: 400"><A HREF="../techwrt-2-3p/t-2-3f.htm"><FONT COLOR="#800000">見出し構成</FONT><FONT COLOR="#000080">と</FONT><FONT COLOR="#800000">見出し名</FONT><FONT COLOR="#000080">の考え方</FONT></A></span></p> <hr> <h2><span style="font-weight: 400"><font color="#800000">要点が明確な段落</font>のまとめ方</span></h2> <p style="LINE-HEIGHT: 150%; TEXT-INDENT: 15px; MARGIN: 1px 10px"> マニュアルのみならず技術文書さらには実務文書でもっとも大切なのは、「<font color="#800000">見出しに続く段落で明確な要点が述べられている</font>」ことです。言い換えれば、主題である見出しに対し「読者が納得する答え」となる1文が当該の段落にあるか否かです。</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-top: 0; margin-bottom: 15" align="center"> <img border="1" src="../techwrt-2-2p/1026.jpg" hspace="2" vspace="5" width="384" height="288"><img border="1" src="../techwrt-2-2p/1040.jpg" hspace="2" vspace="5" width="384" height="288"><p> <IMG SRC="../gif/knrn-lnk.gif" ALT="" width="140" height="35"><span style="font-weight: 400"><font color="#006600" size="4">第2部</font></span>　<span style="font-weight: 400"><A HREF="../techwrt-2-2p/t-2-2f.htm" TARGET="_parent"><FONT COLOR="#800000">段落構成</FONT><FONT COLOR="#000080">の考え方と</FONT><FONT COLOR="#800000">箇条書き、図・表、注記</FONT><FONT COLOR="#000080">の使い方</FONT></A></span></p> <HR> <p> <A HREF="t101c2.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>