「ドキュメントの書き方」を体系的に学んだことがないエンジニアへ 書籍『エンジニアのためのドキュメントライティング』の概要

インフラエンジニア向けの書籍を取り上げ、著者と出会い、楽しく本を知り、仲間を作る場所である「インフラエンジニアBooks」。ここで、『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』の翻訳を担当した岩瀬氏が登壇。まずは、本書籍の概要について話します。 本セッションの対象者と、セッションのゴール 岩瀬義昌氏：ご紹介いただきました、岩瀬と申します。よろしくお願いします。『ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング』は、もともと『Docs for Developers: An Engineer’s Field Guide to Technical Writing』という洋書だったんですが、その翻訳をして、今回この機会をいただいています。 余談ですが、APC（株式会社エーピーコミュニケーションズ）さんが「カプセルト

[fog-og-frog2]

(本題と関係ないけど)この本コーギー犬のイラストがほんと可愛いのよ（๑ ᷇ 𖥦 ᷆๑)♡

[bosatsumiroku]

こんなよりもっといい本はある。Amazonで検索せよ。エンジニアのためという修飾に惑わされてはいけない。結局遠回りになるだけ。

[chintaro3]

　「ドキュメントに関しても、プロダクトの1つなんですよね。」その視点が無い現場が多すぎなのよね。まともな予算と時間が割り当てられてなくて、ドキュメント書いてると「なに遊んでるんだ」とか言われがち

[mozukuyummy]

JTCにおいてドキュメントとは、不具合の責任をたらい回しにして読者を煙に巻くためのアリバイ文書なので、想定読者は存在しない。読者を想定した時点で、その「読者」から責任を取らされて会社員人生が終わる。

[kiyoshi_net]

あとで読む

[nagabow]

メモ

[dkfj]

体系的なドキュメントの書き方って、なかなか学ぶことがないですよね。この辺りもカバーする本が出てきた。一子相伝で学んできた暗黙知が、どんどん形式知になっていっている。素晴らしい

[John_Kawanishi]

「理科系の作文技術」は読んだなぁ

[tattyu]

ドキュメントは書き方そのものも大事だと思うがそれ以上にモチベーションが大事だと思う。

[dogusare]

併せて「ドキュメントの読み方」を体系的に学ぶ必要を感じている中年…（じっと手を見る