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

<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>」の要件</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> <ul> <li> <p style="line-height: 150%; margin-top:0; margin-bottom:15"> <font color="#000080"> この「理解の負担となる要素」と「理解を促進する手法」の一部をテクニカルライティングの観点で解説するのが当サイトのテーマです．</font></p> </li> </ul> </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%; margin: 1 10; text-indent:15"> 文書作成の観点から「わかりやすいマニュアルの要件」を大別すると，「<font color="#800000">“見通しがよい”見出し構成</font>」，「<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: 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="t1-001.jpg" vspace="10" width="432" height="324"><hr> <h2><span style="font-weight: 400">「<font color="#800000">わかりやすく作成するには工夫を要する</font>」マニュアルの“<font color="#800000">わかりやすい</font>”化</span></h2> <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">たとえば，知識の基盤が乏しい読者に多機能な製品の操作方法を解説する場合です．</font></p> </li> <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; text-indent:15"> 「わかりやすく作成するには工夫を要するマニュアル」の多くは，その製品を開発された方々あるいは運用をサポートされる方々が限られた時間で執筆されているのが実情です．これらの方々にテクニカルライティングの知識と手法を提供し支援するのが当社の使命と考えています．</p> <p style="line-height: 150%; margin-top: 0; margin-bottom: 15" align="center"> <img border="1" src="t1-002.jpg" vspace="10" width="432" height="324"><HR> <p> <A HREF="t101c1.htm" TARGET="_parent"><IMG SRC="../gif/0000.gif" ALIGN=bottom width="37" height="37"></A> <B>次ページに進む（ボタンをクリックしてください）</B></p> <hr> <p><B>＜<FONT COLOR="#800000">当コーナー</FONT>の<FONT COLOR="#800000">主旨</FONT>とご閲覧にあたっての<FONT COLOR="#800000">お願い</FONT>＞</B></p> <TABLE BGCOLOR="#000080" cellspacing="1" style="border-collapse: collapse" bordercolor="#111111" width="90%" cellpadding="6"> <TR> <TD BGCOLOR="#ffffff"> <p style="line-height: 150%; margin-top: 5; margin-bottom: 5; margin-right:10; text-indent:15"> 当コーナーは，当社の<FONT COLOR="#800000">テクニカルライティング研修コース</FONT><FONT COLOR="#000000">（出張開催セミナー）</FONT>の抜粋・プレビュー版です．<ul> <li> <p style="line-height: 150%; margin-top: 5; margin-bottom: 5">当コーナーの内容を各種の文書作成の参考にしていただくことは作者の意とするところであり，これが皆様のお役に立てば誠に幸いです．ただし，内容の一部あるいは全部の転載（他のWebサイトや他の出版物，等に収録・再配布する）および当著作物の二次使用を禁じます．</li> <LI TYPE=disc> <p style="line-height: 150%; margin-top: 5; margin-bottom: 5"> また，上記の主旨より当コーナーはご覧いただいた方々に議論を呈することを目的としておりません．当社セミナーの開催に関するお問合せ以外には，お答えいたしかねる場合がありますのであらかじめご了承ください．</ul> </TD> </TR> </TABLE> <DIV ALIGN=CENTER>　</DIV> <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>