エンジニアのためのドキュメントライティング

日本能率協会マネジメントセンター
ジャレッド・バーディ　ザッカリー・サラ・コーライセン　ジェン・ランボーン　デービッド・ヌーニェス　ハイディ・ウォーターハウス　

• 価格: 2,860円（本体2,600円＋税）
• 発行年月: 2023年03月
• 判型: Ａ５
• ISBN: 9784800590831

内容情報

[BOOKデータベースより]

なぜ、こんなにドキュメントが軽視されるんだろう？すぐれたドキュメントがなければ、ユーザーに使われる機会が確実に減ります。開発者がいかにすばらしいプロダクトを作ろうが、ドキュメントの欠如がその価値を奪うのです。本書は開発者向けドキュメント作成においてその経験に長けた執筆者たちがドキュメントを作成し、運用する方法をゼロから説明するフィールドガイドです。

１　ドキュメント作成の準備（読み手の理解；ドキュメントの計画）
２　ドキュメントの作成（ドキュメントのドラフト；ドキュメントの編集；サンプルコードの組み込み；ビジュアルコンテンツの追加）
３　ドキュメントの公開と運用（ドキュメントの公開；フィードバックの収集と組み込み；ドキュメントの品質測定；ドキュメントの構成；ドキュメントの保守と非推奨化）

[日販商品データベースより]

「ドキュメントを書いておけばよかった」

開発者であれば一度は思ったことがあるかもしれません。

ドキュメントは開発側の生産性とユーザーの利便性を高めるものです。
さらに言うと、ドキュメントがなければ、ユーザーに使われる機会が確実に減ります。
開発者がいかにすばらしいプロダクトを作ろうが、ドキュメントの欠如がその価値を奪うのです。

本書は経験に長けた執筆者たちがドキュメントを作成する方法をゼロから説明するフィールドガイドです。
架空のソフトウェア開発チームのストーリーを追いながら、ソフトウェア開発ライフサイクルの各ステップにおいて、ユーザーニーズの理解、開発者に役立つドキュメントの作成、公開、測定、保守に至るまで、開発を最適化するためのドキュメント作成の技術を解説しています。
これまで学ぶ機会のなかったREADME、APIリファレンス、チュートリアル、コンセプトドキュメント、リリースノートなど、さまざまな種類のドキュメントの書き方について学ぶことができる一冊です。

ドキュメントを作成している現場のエンジニアやテクニカルライター、プロダクトマネジャーの方に最適の内容です。