実践テクニカルライティングセミナー－マニュアル作成の進め方とわかりやすいマニュアルのポイント－

<BODY BGCOLOR="#ffffff" LINK="#ffffff" ALINK="#ebc83d" VLINK="#ffffff"> <P> <img border="0" src="../gif/sec2.gif" alt="執筆のポイント" width="540" height="26"><BR> <IMG SRC="../gif/tw2-5.gif" ALT="製品の解説と操作手順の表し方" width="570" height="150"><hr> <H1> <span style="font-weight: 400"><font color="#800000">指示文</font><font color="#000080">の基本</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">1項目＝1行為</font>」の原則</span></h2> <p style="line-height: 150%; margin: 1 10; text-indent:15"> いくつかの指示文で手順（箇条書き形式）を構成する際、その1項目に表す指示文は一つ（1行為）とするのが原則です。操作マニュアルなどで不要に複数の指示文を1項目にまとめると、誤操作につながるおそれがあります。</p> <ul> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> ただし、「一連で完結（途中で断続しない）する行為」あるいは「複数の行為で構成されるが、既知の行為であり誤るおそれがない行為」は１行為扱いとします。</font></p> </li> </ul> <p style="margin:1 10; line-height: 150%; text-indent:15"> とりわけ、途中で結果の確認を要する手順では、不要に複数の操作を1項目にまとめないのが基本です。<P align="center"> <img border="1" src="1054.jpg" vspace="10" width="384" height="288"><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> <li> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15"> <font color="#000080"> 複数の行為者がかかわる行動マニュアルあるいは業務マニュアルでも同様に「行為者Aが・・・」、「行為者Bが・・・」とする場合があります。</font></li> </ul> <p align="center"><img border="1" src="1055.jpg" vspace="10" width="384" height="288"></p> <HR> <p> <A HREF="t-2-5abs04fa.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 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> <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>