ドキュメント作成スキル向上を目指す人向けおすすめ記事まとめ

システム開発にドキュメントは欠かせません。ドキュメントが得意になれば活躍の幅が大いに広がりますよね。

この記事では、まず冒頭でドキュメントの作成に求められると思うことを整理した上で、そのスキル獲得に役立つと思われる記事や書籍を集めてみました。もちろん他にもあると思うので、もしお薦めのものがあれば是非コメントで教えて下さい:grinning:

###更新履歴
・2021/04/16：文章術系にリンクを追加しました。
・2020/11/28：文章術系にリンクを追加しました。
・2020/07/24：文章術系にリンクを追加しました。
・2020/05/24：文章術系にリンクを追加しました。
・2020/05/14：スライドデザイン系にリンクを追加しました。
・2020/04/29：スライドデザイン系にリンクを追加しました。
・2020/04/17：文章術系にリンクを追加しました。
・2020/04/12：関連するTwitterのリンクとお薦め書籍を追加しました。

# システム開発系ドキュメントの作成に求められること
## システム開発系ドキュメントの特徴
- 自分以外の誰かが、参照更には更新する可能性がある資料である
    - レビュワー
    - 後工程の担当者
    - 保守担当者

- 抜け漏れや、読み手によって解釈が異なることは許されない
    - 検討すべきことの抜け漏れは、要件の未達成から手戻りにつながる
    - 解釈が異なる記述をしてしまった場合も同様に、後工程の不具合につながりやすい
 
- 納期があり生産性が求められる
    - 書き手が納得いくまで時間をかけて良いわけではないので、生産性を高める工夫が必要
    - 事前に作成にかかる工数の見積りが求められる

## システム開発系ドキュメントに求められること
- 品質（特に当たり前品質）
    - 誤字脱字、最低限の体裁、表記統一
    - 書くべき項目がすべて書かれている
    - 内容が正確

- 読み手にわかりやすいこと
    - 全体構成、見出しの粒度、順序が適切
    - 文章としてわかりやすい
    - 体裁が適切に「デザイン」されていること
        - タイトル、表紙、インデント、ページ番号など
        - ドキュメントの要件に合った適切なツール選定

- 生産性や作業管理性が高いこと
    - 標準化され一定のルールがある方が書きやすい
    - 作成にかかるタスクが分解できている（見積りの精度が上がる）
    - 完了までの段取りが出来ている（アウトライン化）

# おすすめ記事や書籍

## 文章術系
[誰がどう見てもそうとしか受け取れない文書術（公開版） - Speaker Deck](https://speakerdeck.com/namura/shui-gadoujian-temosoutosikashou-kequ-renaiwen-shu-shu-gong-kai-ban)
「伝わる」ためには何が必要かがコンセプトから実践レベルまで書き込まれた珠玉の文書作成ノウハウ集。必見です。
<blockquote class="twitter-tweet"><p lang="ja" dir="ltr">テレワークが増えチャット、メール等のテキスト連絡の認識齟齬を減らすことに役立てばと思い、全国各地で登壇させてもらっている「<a href="https://twitter.com/hashtag/%E8%AA%B0%E3%81%8C%E3%81%A9%E3%81%86%E8%A6%8B%E3%81%A6%E3%82%82%E3%81%9D%E3%81%86%E3%81%A8%E3%81%97%E3%81%8B%E5%8F%97%E3%81%91%E5%8F%96%E3%82%8C%E3%81%AA%E3%81%84%E6%96%87%E6%9B%B8%E8%A1%93?src=hash&amp;ref_src=twsrc%5Etfw">#誰がどう見てもそうとしか受け取れない文書術</a>」のセミナーの公開版スライドを作りました。<br><br>役立つようであればシェアいただければ幸甚です。<a href="https://t.co/AznG4s4cjz">https://t.co/AznG4s4cjz</a></p>&mdash; 名村 晋治@Webディレクター25年目 (@yakumo) <a href="https://twitter.com/yakumo/status/1244123701005574145?ref_src=twsrc%5Etfw">March 29, 2020</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

[誰にでも分かるSEのための文章術 - ＠IT](https://www.atmarkit.co.jp/ait/series/2404/)
元SEのライターさんによる全15タイトルからなるドキュメント作成に関する記事群。目次の大切さが何度も出てきます。

[まんがでわかる　理科系の作文技術 | 木下是雄, 久間月慧太郎 | ビジネス・経済 | Kindleストア | Amazon](https://www.amazon.co.jp/%E3%81%BE%E3%82%93%E3%81%8C%E3%81%A7%E3%82%8F%E3%81%8B%E3%82%8B-%E7%90%86%E7%A7%91%E7%B3%BB%E3%81%AE%E4%BD%9C%E6%96%87%E6%8A%80%E8%A1%93-%E6%9C%A8%E4%B8%8B%E6%98%AF%E9%9B%84-ebook/dp/B07BRT5372/ref=pd_aw_sbs_351_1/357-9821485-8871360?_encoding=UTF8&pd_rd_i=B07BRT5372&pd_rd_r=d0a41af4-f2b5-4e63-bbf8-a3c60d3097b3&pd_rd_w=kX4Qy&pd_rd_wg=Fr3oU&pf_rd_p=1893a417-ba87-4709-ab4f-0dece788c310&pf_rd_r=3ASG47JVJ435WRTBYNGD&psc=1&refRID=3ASG47JVJ435WRTBYNGD)
読みつがれる名著のマンガ版です。ハードルがぐっと下がりました。是非お薦め。

[技術者のためのテクニカルライティング入門講座｜髙橋 慈子](https://amzn.to/2UZBJOj)（2020/04/11追加）
構造化思考から業務で使うメールや文章の実践的なライティングノウハウまで、この1冊で丸っとおさえられます。チェックリストがいいですね。

[社内で行ったビジネスライティング講座資料を公開します | Developers.IO](https://dev.classmethod.jp/articles/business-writing-howto/)（2020/04/17追加）
主にチャットや社内文書などのテキストコミュニケーションにおける注意点を中心に記載されています。日本語校正ツール/アドオンの利用は確かに効果的。私はMicrosoft Wordに貼り付けて波線チェックしています。

[Google社のテクニカルライティングの基礎教育資料がとても良かったので紹介したい - Qiita](https://qiita.com/yasuoyasuo/items/c43783316a4d141a140f)（2020/05/24追加）
テクニカルライティングの原理原則の紹介です。是非多くの人に読んでもらいたいです。

[LINE社内で大評判のテクニカルライティング講座で説明した内容をあらためてブログにまとめてみた - LINE ENGINEERING](https://engineering.linecorp.com/ja/blog/line-technical-writing-course/)（2020/07/24追加）
読み手にわかりやすく誤解を減らせる文章にするために、推敲の大切さをうたわれています。選択肢（文案）を多く用意し最適なものを選ぶという手法は誰にもできそうですが、いざ実行しようとするとなかなか真似できないことではないでしょうか。わかりやすい文章をつくるのに銀の弾丸はないのだということを改めて思い知らされます。丁寧な解説や事例が豊富でおすすめです。

[ドキュメントを書くときの「メンタルモデルの原則」 - クックパッド開発者ブログ](https://techlife.cookpad.com/entry/2020/11/27/104826)（2020/11/28追加）
「演繹的・帰納的な説明により推測を可能にする」という観点が大変参考になります。
`「前提としていることを説明」「繰り返しやパターンで説明」を意識してドキュメントを書く`
ことでそのドキュメントの使いやすさが大きく変わりますね。

[エンジニアのための、いますぐ使える文章校正テクニック - ICS MEDIA](https://ics.media/entry/19096/)（2021/04/16追加）
最後の一手間で大きく文章品質を高める具体的なテクニックが大変参考になります。

##前提となる知識系
[要望・要求・要件・仕様・制約・前提の違いは？](https://qiita.com/digdagdag/items/2808205d89344ab8a3a1)
システム開発に頻出用語ながら定義があいまいになりがちな言葉を明確にすることができます。

[構造化とは｜構造化の意味と【5つの構造化思考】を徹底解説 - Mission Driven Brand](https://www.missiondrivenbrand.jp/entry/thinking__Structured)
高品質なドキュメントを作成する上で欠かせない構造化思考の考え方が学べます。

[【9割の人ができない】「仕事が遅い人」がやっていないたった一つのこと | まこなりの社長室](http://makonari.com/?p=339)
ここで述べられているアウトラインから考える思考は、ドキュメント作成というタスクについては特に重要ですね。

[エンジニアのためのドキュメント力基礎講座 - Speaker Deck（2020/04/09追記）](https://speakerdeck.com/yasuoyasuo/enziniafalsetamefalsedokiyumentoli-ji-chu-jiang-zuo)
ドキュメント作成に不可欠な構造化思考に的を絞った拙作の社内研修用資料です。
<blockquote class="twitter-tweet"><p lang="ja" dir="ltr">エンジニアに向けたドキュメント作成能力向上のための社内研修用のコンテンツを一部加工して公開しました。品質の高いドキュメントを効率的に作るための最初の一歩を埋めてもらうことを狙っています。宜しければご覧ください！<br><br>エンジニアのためのドキュメント力基礎講座 <a href="https://t.co/iCLSlD0lft">https://t.co/iCLSlD0lft</a></p>&mdash; 中野康雄＠ARI (@yasuoyasuo) <a href="https://twitter.com/yasuoyasuo/status/1247886599603421184?ref_src=twsrc%5Etfw">April 8, 2020</a></blockquote> <script async src="https://platform.twitter.com/widgets.js" charset="utf-8"></script>

##システム開発やプロジェクト方法論系
[はじめての要件定義で読むべきIPAドキュメント - Qiita](https://qiita.com/cask_st/items/5fd70bda63f9acf22a30)
IPAのドキュメントは色々参考になりますね。要件定義初心者は必見！

[今、システム開発の実態はどうなっているのか | Think IT（シンクイット）](https://thinkit.co.jp/article/16984)
2020/04/08現在まだ連載中。ツールの紹介側面もあるが、システム開発におけるドキュメント作成の位置付けがよく理解できます。

[チェックリストでリスクを見つけてプロジェクトを幸せにしよう](https://qiita.com/YusukeSaito/items/45d425c55bebf7aedb04)
プロジェクトにおけるドキュメントに関するアンチパターンが学べます。（3.11.など）

[要件定義基礎研修テキスト | Fintan](https://fintan.jp/?p=1389)
TIS株式会社のノウハウ公開サイトより。大規模システム向け。このコンテンツ以外もサイト全体が諸々参考になります。

##エンジニアさんのノウハウ系
[エンジニア歴20数年の私が、設計書を書く際に心がけていること - Qiita](https://qiita.com/y-some/items/90651c1e27f7798f87c6)
ベテランエンジニアならでは実務目線かつ網羅的な記載。でも読みやすいです。

[仕様書の書き方 - Qiita](https://qiita.com/ko1/items/9f5f1a2683ea54f12362)
シンプルですがポイントを抑えています。書く内容を必要最低限に絞りたい時に参考にすると効果的です。

##スライドデザイン系
[エンジニアのためのスライドデザイン実践講座 / How to design presentations for engineers - Speaker Deck](https://speakerdeck.com/ken_c_lo/how-to-design-presentations-for-engineers)
かっこいいスライドを作って、どんどん発信しましょう！

[【プレゼン】見やすいプレゼン資料の作り方【初心者用】](https://www.slideshare.net/yutamorishige50/how-to-present-better)（2020/04/29追記）
プレゼン用スライドデザインにおける「イロハのイ」がちょうどよいボリューム感で語られている。タイトルの通りプレゼン初心者におすすめです。PPTユーザを想定していて、PPTにおけるデフォルトフォントの設定方法など効果的な利用方法の記載があるのは嬉しいですね。

[PowerPoint資料作成　プロフェッショナルの大原則 | 松上 純一郎 | ビジネス教育 | Kindleストア | Amazon](https://www.amazon.co.jp/dp/B07MZ1FLZP/)（2020/05/14追記）
コンサルティングや上流工程におけるPowerPoint資料の作り方についての網羅性で言えばこの1冊がよいです。著者の[ページ](https://www.rubato.co/media_list/book_pro_pdfdownload)から前半部分のPDFがダウンロードできる。気になる方はチェックしてみてください。

[社内プレゼンの資料作成術 | 前田 鎌利 |本 | 通販 | Amazon](https://www.amazon.co.jp/dp/4478061521/)（2020/05/14追記）
会議で人を動かすためのプレゼン資料が作りたい人はこの資料をみてください。ちょっと考え方が変わるかも知れません。

# その他おすすめ書籍
[文章を書く上で参考になった本 3冊｜中野康雄＠ARI｜note](https://note.com/yasuoyasuo/n/ne97d1b157a31)
ビジネスドキュメントというよりも文章という意味ですが、自分のお薦め本を3+1冊挙げた記事です。

[【改訂第２版】［入門＋実践］要求を仕様化する技術・表現する技術 ～仕様が書けていますか？ | 清水 吉男 | コンピュータ・IT | Kindleストア | Amazon](https://www.amazon.co.jp/gp/product/B07729YVZC/ref=ppx_yo_dt_b_d_asin_title_o05?ie=UTF8&psc=1)（2020/04/12追記）
要求仕様の言語化技術であるUSDMという手法を軸に、要求の仕様化技術を紹介しています。日本語の扱い方も参考になります。

[なぜ重大な問題を見逃すのか？間違いだらけの設計レビュー改訂版（日経BP Next ICT選書） | 森崎修司, 日経SYSTEMS | 工学 | Kindleストア | Amazon](https://www.amazon.co.jp/gp/product/B01683BFJM/ref=ppx_yo_dt_b_search_asin_title?ie=UTF8&psc=1)（2020/04/12追記）
ドキュメントにレビューは不可欠ですが、そのやり方自己流という方も多いのでは？私もそうでした。レビューの正しく効果的なやり方を教えてくれる本です。

--
今のところ以上ですが、他にもいろいろあると思うので是非教えて下さい！