|
「目的に応じた技術文をいかに書くか」を切り口にテクニカルライティング（技術文書を作成するための知識と手法の体系）の基本的な考え方を解説します。さらに、テクニカルライティングを基盤にして各種の技術文書（報告書、機能仕様書、製品解説、マニュアルなど）をまとめる際のポイントを解説します。 |
「わかっているのだが、書けない」と思っていても、なんらかの“きっかけ”で文が浮かぶ場合があります。また、書けなくとも「尋ねられると、説明できる」こともあります。「文にまとまらない」という発散的な状態から「文にまとまる」に収束する“きっかけ”を得る手法があれば執筆が効率化するはずです。
「報告内容については自分がもっともよく知っているのだが、報告書の最初の1文がうまく書けない」あるいは「製品解説の第1文が書けても、その先が続かない」 というのは、もどかしくストレスをはらんだ状態です。書き始める際は頭の中の情報量がピークとも言える思考の飽和状態です。“うまく”まとめようとする、それがさらに執筆者の負担になります。
まとまらないからと言って、「以下に・・・について解説します」としただけでは何の解決にもなりませんし、図を示しただけでは読者に「要点は何」と指摘されてしまいます。下書きしたり、ロジカルシンキング（問題解決手法）で思考を分析し始めては、大げさになり時間を要します。
解決策は、「テクニカルライティング」にあります。けして、大げさな手法を述べるつもりはありません。文は「書こうとする対象」の“とらえ方”から生まれます。対象をどのような「視点」あるいは「見方」でとらえるかを“きっかけ”にすれば、飽和状態の思考に方向性が生まれ主題（書こうとするテーマ）に応じた文をまとめられるはずです。
文の冒頭で「本製品は」と書いた後に手が止まってしまうのならば、製品を十分に知っていても、文書の目的に応じたとらえ方が十分でないのかもしれません。方向性をもたずワープロに向かい、「・・・は」と見切り発車で入力しても、文は生まれません。無理にその後を続けても「長文」あるいは「主語と述語の対応が不自然な文」に陥りやすくなります。執筆者は、またそこで考え込んでしまうことになります。
同じ主題であっても、「話す」と「書く」では状況が異なります。対話では、相手と自分の関係が明確であり、語るべき主題もいくつかに分割（対話の一区切り）されます。また、必要ならば相手が補足を求めてきます。相手がいて、主題を大局的あるいは部分的な見方で分割して尋ねてくれれば、それに沿って答えて行くだけで説明が成り立ちます。
たとえば、上司に対話である課題が解決したことを報告するとします。「（私が担当した）問題は解決しました」、「いくつかの原因が複合していますが、直接原因は＊＊＊です」と要点から報告します。もし要点を述べないと、上司が「細かい話は後でいいから、結論を先に言ってくれ」と要点を促します。この際、「（私は）設計変更が必要と考えます」と言葉に表れませんが、報告者の視点で見解を述べます。人称としてとらえれば「私（I）」です。
あるいは、展示会で来場者に製品を説明するとします。来場者の傍らでともに製品を前にして、来場者が知っている用語を主体にして語り、知らないであろう用語を使った場合はすぐに補足するでしょう。説明者は来客に「お客様」と呼びかけますが、人称としてとらえれば「あなた（You）」です。「（あなたの）問題を解決します。（あなたは）是非お試しください」と来場者の視点で語るはずです。
ならば、「書く」でも対話と“同じような状況（相手との関係、大局的あるいは部分的な見方）”を仮想的に構築すれば、「書けない」の問題は解決に向かうはずです。
ここで言う“同じような状況で書く”とは、対話での「主題に対する一区切りの大局的あるいは部分的な見方」と「相手との関係」を文に反映することです。けして「対話形式で文をまとめる」あるいは「会話調の文体で書く」ことではありません。
「話す際の主題」と「主題に対する一区切りの説明」は、文書では「見出し」と「段落」に相当します。さらに「大局的あるいは部分的な見方」と「相手との関係」は、テクニカルライティングの手法ではそれぞれ「主文−補足文」構成と「主たる視点」に対応します。いずれも、読者の理解につながるとともに執筆者が文をまとめる“きっかけ（導入）”になりえます。また、「主文−補足文」構成と「主たる視点」によって文もしくは段落のアウトライン（輪郭）が構成されます。
「主文−補足文」構成とは、段落を「主文（見出しに対する要点）」と「補足文（主文の補足）」で構成する手法です。
「全体と部分（構成要素）」あるいは「主体と補足」による構成は、執筆者が書こうとしている主題（見出し名）に対し「全体としては」と「その部分は」という文にまとめる“きっかけ”を提示します。
また、読者にとっては「明確な要点とそれに必要な付帯情報」になり、「主文−補足文」構成は執筆者と読者の双方に有効です。
「主たる視点」とは、技術文書を「仮想空間」としてとらえた際に「中心になって行為する人」です。いわゆる「人称」に相当します。仮想空間の“主役”とご理解ください。技術文書に限らず日本語の文書では、執筆者と読者の関係が人称に反映されます。文書目的に応じて「主たる視点」を的確に位置付けると、文体が統一されるとともに執筆者と読者の関係が明確になります。
たとえば、製品を対話で説明する際には「傍らにいるあなた」に向けて語ります。同様に、製品解説・マニュアルでは文には表れませんが「（ユーザである）あなた」が「主たる視点」になります。
「主たる視点」は、単に「省略された主語」ではなく、「（あなた）により／（あなた）にとって／（あなた）には／（あなた）から見ると」など活用形となり、文には表れなくとも文をまとめる“きっかけ”になります。
「主文−補足文」構成と「主たる視点」は、特別な手法ではありません。さまざまな技術文書で積み重ねられかつ読者に受け入れられてきた「技術を文書で伝える技術」のエッセンスと言えます。「主文−補足文」構成と「主たる視点」は、各種の技術文書を作成する際の基盤（いわば、プラットフォーム）になります。また、技術文書のみならずビジネス文書（例：議事録、納入仕様書）などの実務文書にも応用できます。
技術者の皆さんが技術に関するさまざまな課題に向き合う際には、なんらかの「基礎理論」、「目的に応じた実践手段」さらには「問題が発生した際の解決策」をもって臨むはずです。技術文書でこれらに相当するのがまさにテクニカルライティング（技術文書を作成するための知識と手法の体系）です。
テクニカルライティングは、技術者の皆さんが得てこられてきた文書作成の技術を否定するものではありません。むしろ、文書作成を体系的にとらえ補完することにより、得てきた知識を有効に使う手法と言えます。
次ページに進む（ボタンをクリックしてください）技術文書、マニュアルを作成する際の基本をお伝えして、テクニカルライティングへの関心をおもちいただくのが当コーナーの主旨です。
当コーナーの内容を各種の文書作成の参考にしていただくことは作者の意とするところであり、これが皆様のお役に立てば誠に幸いです。ただし、内容の一部あるいは全部の転載（他のWebサイトや他の出版物、等に収録・再配布する） および当著作物の二次使用を禁じます。
上記の主旨より、当コーナーはご覧いただいた方々に議論を呈することを目的としておりません。当社のテクニカルライティングセミナー、文書改善研修およびコンサルティングに関するお問合せ以外には、お答えいたしかねる場合がありますのであらかじめご了承ください。
当社では出張開催形式のテクニカルライティングセミナーおよび文書改善研修を実施しています。当コーナーと基盤になる考え方は同じにしていますが、実務知識が中心の新構成・新内容です。
実践テクニカルライティングセミナー
マニュアル作成の進め方とわかりやすいマニュアルのポイント
Copyright: Takaaki-YAMANOUCHI/1995-2020
山之内孝明／有限会社 山之内総合研究所
Takaaki Yamanouchi/ Yamanouchi Research Institute, Ltd.