引き継ぎで不幸が生まれるのを経験したり見たりした為に、なんとかしたくてコレを記す。パブリックドメインな文章とするので、自由に改変するなりなんなりして欲しい (このドキュメントを成長させていきたい)
「情報」はドキュメントという形、あるいはソースコードのコメントなど、形式はこのテキストにおいては扱わない。また、なるべくDRY原則に従った形で情報を残すべきだとは思うが、このテキストでは詳細には踏み込まない。
- 関係者一覧
- 誰が出したどういう要望があるのか
- 例外的な事 (わざわざこうせざるを得なかった、制限があったなど)
- 設計/実装されている、ある部分は、どういうものと比較してそれが選択されたのか？ (どうして？何故？)
- API仕様
- 入出力仕様 (たとえばバッチであれば、どういうファイルを受け取って、どういうデータベースをいじって…など)
- 受け入れテスト
- 用語集 (出来ればドメインに従った統一された用語)