わかりやすい技術文書・ビジネス文書の作成手法：第1部　見出し構成の考え方

<BODY BGCOLOR="#ffffff" LINK="#ffffff" ALINK="#ebc83d" VLINK="#ffffff"> <P> <IMG SRC="../gif/gb-bar1a.gif" ALT="文書構成の考え方" ALIGN=bottom WIDTH=540 HEIGHT=26><BR> <IMG SRC="../gif/gb-1-ttl.gif" ALT="見出し構成の考え方" ALIGN=bottom WIDTH=570 HEIGHT=150><HR><H1> <span style="font-weight: 400"><font color="#800000">機能</font><B><font color="#800000">仕様書</font>の見出し構成</B></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="line-height: 150%; margin-top: 2; margin-bottom: 0; margin-left:10; margin-right:10; 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>」で構成されるのが通例です．総論部は2ないし3章，各論部は製品の構成にもよりますが5章から10章程度が一般的です．</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: 1 10" align="center"> <img border="1" src="0007a.jpg" vspace="10" width="480" height="360"></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"> 機能仕様書は定型を基本としているため，<font color="#800000">下位の見出しが細分される傾向</font>があります．この際，不要に下位の見出し（項見出し）まで定型構成にすると，4ランク以上に見出しが細分されるとともに<font color="#800000">項見出しランクのページ数が大きくなる不均衡</font>を生じやすくなります．</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="0008a.jpg" vspace="10" width="480" height="360"></p> <p style="line-height: 150%; margin: 1 10; text-indent:15"> 節見出しを「重要事項の基本単位」とし，<font color="#800000">階層ではなく並列に構成</font>するのが適当です．全体から部分へ階層化するのではなく，「全体」，「部分」，「周辺」をそれぞれ並列に構成すれば，重要な事項が下位の見出しランクにならずにすみます．</p> <ul> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"><FONT COLOR="#000080"> 技術文書では，「階層化＝体系的」ととらえ必要以上に見出しを細分する傾向がありますが，「階層的＝重要項目の下位扱い」となる場合が多くむしろデメリットになりかねません．過渡に階層化すると，見出しランクが3ランクあるいは4ランクでも不足して変則的な見出し構成あるいは見落としが多い見出し構成に陥りやすくなります．</FONT></p> </li> </ul> <p style="line-height: 150%; margin: 1 10" align="center"> <img border="1" src="0009a.jpg" vspace="10" width="480" height="360"></p> <HR> <p> <A HREF="tgb-01-03f.htm" TARGET="_parent"> <IMG SRC="../t1/nxt.gif" ALT="" 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 width="282" height="24" hspace="2" vspace="2"></a><a TARGET="_blank" href="../t-smnr-trf/smnr-trf02.pdf"><IMG SRC="../gif/tsub-trf.gif" ALT="セミナー基本料金［抜粋PDF版］" ALIGN=bottom BORDER=0 width="282" height="24" hspace="2" vspace="2"></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> <B>テクニカルドキュメント・ビジネスドキュメントためのテクニカルライティングセミナー</B><BR> <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>