仕様書の履歴(No.10)

情報†

Joelの機能仕様書は、ユーザー視点でソフトウエアの動作や画面の仕様（＝いわゆるユーザー体験の仕様）を記述し、ユーザーと開発者とが情報共有（共通理解）をするためのドキュメントです。

この記事では、まず冒頭でドキュメントの作成に求められると思うことを整理した上で、そのスキル獲得に役立つと思われる記事や書籍を集めてみました。

外部設計工程における、発注者にわかりやすい仕様の記述方法及び合意方法を世の中に広く普及することを目的としています。

自己流の手順書フォーマットを公開してみた | DevelopersIO
```
みなさんは自己流または、組織やプロジェクトで定められた手順書のフォーマットはありますか? 私は自己流の手順書フォーマットがあります。
```
- コメント：VisualStudioCodeでの文書作成、Markdownでの章ナンバリング方法、HTML/PDFエクスポートの比較あり。(2021/11/14)

例: 何をお願いしたいか不明瞭
× 〜という事象が発生します。確認をお願い致します。
言われた通りに「確認しました。」という回答ではほとんどのパターンが満足されません。（理不尽）
○ 〜という事象が発生します。この事象が発生しないようにしたいので、対策を教えてください。

テクニカルライティングの基本を学べます。サイボウズの新入社員向け研修資料です。業務マニュアル、報告書、仕様書、技術解説書などのドキュメントを書く機会がある方向け。