2012年8月23日

ドキュメントってさ・・・

いつまでたっても尽きないソフトウェア開発におけるドキュメントについてのお話。 ってか、エンジニア同士のやり取りだと結論出やすいんだから、問題は政治的な話のような気がする。
0
きっかけ
英吉 @LuckOfWise

ドキュメントに全て起こす事によって他社をコントロールするという発想はいかがなものかと。

2012-08-23 10:16:58
あべさん @mao_instantlife

@LuckOfWise 胸が痛むわ^^; まあ、「すべて」は無理だけどさ。

2012-08-23 10:19:16
英吉 @LuckOfWise

@mao_instantlife ドキュメントが悪だとは言わないけど、"それだけ"じゃ無理だよね。

2012-08-23 10:24:56
あべさん @mao_instantlife

@LuckOfWise そうそう。ドキュメントに書けないこともあるからね。サテライトになるとか規模が大きいとかになると、コミュニケーションを補完する意味でドキュメントにどこまで書くか、が重要になるけど。 目的に応じてドキュメントの質と量って変わるもんじゃないかな。

2012-08-23 10:30:30
英吉 @LuckOfWise

@mao_instantlife 全てのテストケースをドキュメントに洗い出して指示出さないとテストしてもらえないじゃないかって吠えてるおばさんがいて、かわいそうな気持ちになっているなう

2012-08-23 10:31:54
あべさん @mao_instantlife

@LuckOfWise ああ、いるわそういう人。。。南無。。。

2012-08-23 10:36:45
ぜっちゃんも参加
Yoshida Takafumi @zephiransas

ドキュメントなんてただの出がらしみたいなもん。それ自体に価値はない

2012-08-23 10:26:03
あべさん @mao_instantlife

@zephiransas 保守や運用のために残しておく必要があるものもあるし、サテライトチームでやる場合はむしろドキュメントにした方が良い情報もあるよ。一概に価値がないとは言えないんじゃないかな? コンパクトで一か所に固まったチームだと価値がないことが多いのは認めるけど。

2012-08-23 10:35:37
Yoshida Takafumi @zephiransas

@mao_instantlife 理想とする開発スタイルの話になっちゃうけど、自分はコンパクトなスタイルにこそ価値があると考えてるから、ドキュメントの価値は否定しがち^^;

2012-08-23 10:37:04
英吉 @LuckOfWise

@zephiransas @mao_instantlife うちのチームもドキュメントは残してるぞ!wikiにだけど。

2012-08-23 10:38:39
あべさん @mao_instantlife

@zephiransas 確かにそのスタイルであればドキュメントが価値を持つケースは少なくなるはず。

2012-08-23 10:39:05
Yoshida Takafumi @zephiransas

@LuckOfWise @mao_instantlife Wikiだとできることが少ない(≒シンプル)なので、逆にそれがいいんじゃないかなと。真面目な人ほど、全てを網羅したがる。

2012-08-23 10:40:11
あべさん @mao_instantlife

@LuckOfWise @zephiransas ドキュメントは別に形にこだわらなくても良いんじゃない?ソフトウェアの設計情報って多岐にわたることが多いから、wiki(というかハイパーリンクが使える媒体)の方が向いてると思うし。

2012-08-23 10:40:35
あべさん @mao_instantlife

それにWikiの方がバージョン管理システムで扱いやすいんじゃね?

2012-08-23 10:42:24
Yoshida Takafumi @zephiransas

@mao_instantlife そう、それ!Excelで管理してて、最新でないExcelに仕様変更かけて、アババなケースなら、たった今発生してるw

2012-08-23 10:44:41
あべさん @mao_instantlife

どうせ自分で変更しないんだからWiki -> PDFでも良いんじゃねえか、とか思ったり

2012-08-23 10:55:08
いろふさんとのやり取りも
いろふ @irof

ドキュメントがなぜいるのかを真剣に考えれば、書くことも変わるはず。ドキュメントが必要だから、だと今までの枠内でしか変われない。けど真剣に考えるコストは大きくて、先送り。どうしようもなくなるまで。

2012-08-23 10:32:51
あべさん @mao_instantlife

@irof 必要なドキュメントはチームやお客さんやその後の運営(システムを取り巻くコンテキスト)によって変わるから、プロジェクトごとにほんとは議論が必要ですよね。

2012-08-23 10:37:59

コメント

コメントがまだありません。感想を最初に伝えてみませんか?