·
サーバの構築作業
久しぶりのサーバ構築作業。
サーバの構築作業をしながらドキュメントを作成。
行うことを項目として列挙して、順番を決める。
項目毎に詳細な手順を書いて作業。基本的にはドキュメント先行で作業する。実際に作業してみないとわからない点は作業先行で。
作業が終わった時点で作業手順書みたいなものと、テスト項目を列挙したチェックリストが出来上がってるとベスト。
以下箇条書き
- 2人以上いる場合、上記作業に関係なくブラックボックステスト的なチェックリスト(テスト仕様書)の作成が行える。また、作業手順書に基づいたホワイトボックス的なチェックリストが作成できる。
- 作業手順書＝外部仕様書＋内部仕様書みたいになりつつあるので、外部仕様書として大枠を抜き出すほうがわかりやすい。
- ドキュメントのメンテナンスを考えるとWikiになってるのもいいかもしれない。
- 作業しているとマニュアル化しにくい部分が出てくる、これらは改善の余地だと思う。
とか理想はともかく、まずはできるところまで。
この記事へのコメント
※ このコメントは旧ブログシステム(tDiary)からの移行です。
Esmeraldaさんからのコメント(2007-01-18 18:56:02)