ジャレッド・バーティの作品一覧
「ジャレッド・バーティ」の「ユーザーの問題解決とプロダクトの成功を導く エンジニアのためのドキュメントライティング」ほか、ユーザーレビューをお届けします！
- 作者をフォローする
- フォローすると、この作者の新刊が配信された際に、お知らせします。
作品一覧
-
4.31巻2,574円 (税込)【内容紹介】 「ドキュメントを書いておけばよかった」 開発者であれば一度は思ったことがあるかもしれません。 ドキュメントは開発側の生産性とユーザーの利便性を高めるものです。 さらに言うと、ドキュメントがなければ、ユーザーに使われる機会が確実に減ります。 開発者がいかにすばらしいプロダクトを作ろうが、ドキュメントの欠如がその価値を奪うのです。 本書は経験に長けた執筆者たちがドキュメントを作成する方法をゼロから説明するフィールドガイドです。 架空のソフトウェア開発チームのストーリーを追いながら、ソフトウェア開発ライフサイクルの各ステップにおいて、ユーザーニーズの理解、開発者に役立つドキュメントの作成、公開、測定、保守に至るまで、開発を最適化するためのドキュメント作成の技術を解説しています。 これまで学ぶ機会のなかったREADME、APIリファレンス、チュートリアル、コンセプトドキュメント、リリースノートなど、さまざまな種類のドキュメントの書き方について学ぶことができる一冊です。 ドキュメントを作成している現場のエンジニアやテクニカルライター、プロダクトマネジャーの方に最適の内容です。 【目次】 PART I ドキュメント作成の準備 CHAPTER 1 読み手の理解 CHAPTER 2 ドキュメントの計画 PARTⅡ ドキュメントの作成 CHAPTER 3 ドキュメントのドラフト CHAPTER 4 ドキュメントの編集 CHAPTER 5 サンプルコードの組み込み CHAPTER 6 ビジュアルコンテンツの追加 PARTⅢ ドキュメントの公開と運用 CHAPTER 7 ドキュメントの公開 CHAPTER 8 フィードバックの収集と組み込み CHAPTER 9 ドキュメントの品質測定 CHAPTER 10 ドキュメントの構成 CHAPTER 11 ドキュメントの保守と非推奨化
ユーザーレビュー
-
-
-
Posted by ブクログ
ユーザマニュアルの書き方の解説であるが、他の本と一味違うのは公開、フィードバック、メンテナンスまで扱っていること。ドキュメントは多くの場合、作りっぱなしになってしまうが、そうならないようにするにはどうすればよいかというところにまで配慮が行き届いている。作りっぱなしの問題はすでに起きているので対処法は非常に参考になった。また、ドキュメントの管理もプログラムと同様のバージョン管理システムを用いたりするなどプログラマの視点での解説となっており、プログラマとしては非常に理解しやすかった。そして、この解説自体が解説通りの書き方となっており、具体的のどうすればよいのか？にも答えている。ドキュメントの管理
-
-
Posted by ブクログ
エンジニアによるドキュメント作成（ユーザーガイド、運用手順書、APIリファレンス、設計書など）について、架空のプロジェクトを例にして順を追って解説されている。
ドキュメントの種類・書き方・考え方の概念的な方法論や教訓が、ある程度高いカバー率で網羅されている。基礎的な知識・原理を身につけることで長い目で見て役に立つ知識を得られるものであり、これを読んですぐにそのままマネすれば良い、というものではないと思う。
実務でエンジニアがやりがちな失敗や「考えが及んでいなかった」というケースへの言及が多く、経験者としては耳が痛いし、それゆえに学びが多い。
文量が多くて時間がかかりそうだったため、全体的に見出
