ドキュメントってさ・・・
- mao_instantlife
- 1288
- 0
- 0
- 2
きっかけ
@LuckOfWise そうそう。ドキュメントに書けないこともあるからね。サテライトになるとか規模が大きいとかになると、コミュニケーションを補完する意味でドキュメントにどこまで書くか、が重要になるけど。 目的に応じてドキュメントの質と量って変わるもんじゃないかな。
2012-08-23 10:30:30@mao_instantlife 全てのテストケースをドキュメントに洗い出して指示出さないとテストしてもらえないじゃないかって吠えてるおばさんがいて、かわいそうな気持ちになっているなう
2012-08-23 10:31:54ぜっちゃんも参加
@zephiransas 保守や運用のために残しておく必要があるものもあるし、サテライトチームでやる場合はむしろドキュメントにした方が良い情報もあるよ。一概に価値がないとは言えないんじゃないかな? コンパクトで一か所に固まったチームだと価値がないことが多いのは認めるけど。
2012-08-23 10:35:37@mao_instantlife 理想とする開発スタイルの話になっちゃうけど、自分はコンパクトなスタイルにこそ価値があると考えてるから、ドキュメントの価値は否定しがち^^;
2012-08-23 10:37:04@LuckOfWise @mao_instantlife Wikiだとできることが少ない(≒シンプル)なので、逆にそれがいいんじゃないかなと。真面目な人ほど、全てを網羅したがる。
2012-08-23 10:40:11@LuckOfWise @zephiransas ドキュメントは別に形にこだわらなくても良いんじゃない?ソフトウェアの設計情報って多岐にわたることが多いから、wiki(というかハイパーリンクが使える媒体)の方が向いてると思うし。
2012-08-23 10:40:35@mao_instantlife そう、それ!Excelで管理してて、最新でないExcelに仕様変更かけて、アババなケースなら、たった今発生してるw
2012-08-23 10:44:41いろふさんとのやり取りも
ドキュメントがなぜいるのかを真剣に考えれば、書くことも変わるはず。ドキュメントが必要だから、だと今までの枠内でしか変われない。けど真剣に考えるコストは大きくて、先送り。どうしようもなくなるまで。
2012-08-23 10:32:51@irof 必要なドキュメントはチームやお客さんやその後の運営(システムを取り巻くコンテキスト)によって変わるから、プロジェクトごとにほんとは議論が必要ですよね。
2012-08-23 10:37:59