🐺
TECHNICAL WRITING の参考記事まとめ
はじめに
進捗報告やプレゼンなど報告を行う機会は多いかと思います。
報告を行うためには思考整理し、言語化を行う必要があり
言語化がうまくできていないと、相手に伝わりづらい内容になってしまいます。
実際にこのような経験をした人は私だけではないはず。
そこで今回は、思考整理の手法としてTECHNICAL WRITING
を簡単に紹介しつつ、
参考文献もまとめていきますので是非ハブページとしてお使いいただければと思います。
対象者
本記事では下記の方向けにまとめております。
- 思考整理で悩んでいる人
- 思考整理に興味がある人
- 思考整理の参考文献探すの面倒な人
TECHNICAL WRITING とは
一般的には技術的な内容を目的や読み手に合わせて分かりやすく伝える手法と言われています。
報告書、提案書、議事録、マニュアルと言った
業務の中で技術文書を作成する機会はたくさんあると思いますので
生産性を上げるには重要なスキルの1つです。
課題を見つけるときも、言語化してはじめて理解できるものとなります。
特にエンジニアや研究者は普段から言語化を行うことが多いため
優れた課題を見つける上でも重要なスキルではなかろうかと思います。
参考記事まとめ
ありがたいことに
すでに世の中には沢山の文献があるので
今回はそちらをまとめていきます。
※他にも気になる記事があれば随時更新予定です。
技術者向け
- Googleが公開しているDeveloper向け TECHNICAL WRITING
- Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい
- テクニカルライティングのすすめ
- 【和訳】エンジニアのためのテクニカルライティング by Google
一般向け
- 三菱電機
- 技術文書を書く方に送る、書籍「技術者のためのテクニカルライティング入門講座」
- テクニカルライティングについて学ぶぞ
- 開発ドキュメントの書き方!9つのコツ【エンジニア】
- LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた
テクニカルライター
最後に
今回TECHNICAL WRITING
という手法を学んでいきましたが
思考整理の手順を軽視していたなと感じました。
思考整理に必要な「背景・前提」「課題」「手段・アプローチ」「結果・分析」が立体的になっていることを意識できていなかったことが原因で思考整理に必要以上な時間を投資していた気がします。
私自身もまだまだ学び途中ではありますが、
少しでも興味や解消につながるきっかけになると嬉しい限りです。
Discussion