無駄なドキュメントは書くな（再考）＠大井町の飲み屋談義 - 未来のいつか/hyoshiokの日記

昔、無駄なドキュメントは書くな(http://d.hatena.ne.jp/hyoshiok/20050510#p1)というよた話を書いたのだが、酒の席で、似たようなお話をしたので、いろいろ考えてみた。 酒の席でのお話というのは、次の日すっきり、さっぱり忘れるのが常であるので、詳細はもちろん把握していないのだが、概要程度は思い出せるので、それを再現してみたい。 登場人物は、工程改善チームのおじさんTさん、工程改善チームの若者（初対面）、SIerから転職してきた同じグループで9月入社のSさん、そしてわたくし。大井町の魔界のおでん屋の2階。民家の2階風で、テレビもある。だらだら終電までいればタモリ倶楽部も見られるねと言う感じの飲み屋である。 若者はドキュメントの標準化とかいろいろ悩んでいる。若者「詳細設計ドキュメントとかどうするんすかね？どー標準化するんすかね」、よしおか「そんなものは書かない

[hyoshiok]

1

[int128]

無駄を減らすのは内製のインセンティブ。外注は無駄で飯食ってるから減らさない。

[Kwappa]

『それってウォーターフォールの匂いがしますね』『必要なドキュメントは、そのシステムのWHYを書いたドキュメントである。』『その魂を記したドキュメントである。』 HOW ではなく WHY。HOW ではなく WHY。

[jacoby]

WHYがかいてあるドキュメントだけか。怖いようなキがする

[imai78]

タスクとコストをやりくりしようとすると、割愛出来るもの、不要なものは除外しないと、という話。

[moronbee]

担当が責任逃れをするためのエビデンスと称した無駄なドキュメントが、関係者を不幸にするのが分からない人が多くて困る。(特に官公庁系)／プログラマに限らず、ITに関わる全ての人がこの意識を持てばいいのにと思う

[k-takahashi]

『必要なドキュメントは、そのシステムのWHYを書いたドキュメント』『テストを作らないことは気持ちが悪くて、先に進めない。そーゆー空気を醸し出す』

[iwsky]

「必要なドキュメントは、そのシステムのWHYを書いたドキュメントである。」そう。これ。保守やってるとなんでこうなってる？が分からないものばかりで困ってる。

[kkamegawa]

「テストがかけるコードの作り方」を最初に勉強しないとね。なんかでかい引数どんと作るような処理作って、その引数の情報を作れないからテストできませんとかいうことになりがちだし

[mokuden]

中は見れば判る。そうだそうだ。WHYを書かないと中見ても理解できないと思う。

[rochefort]

テストが書けない場合は、書ける言語に移行すべきなんでしょうね。

[yukinarian0]

デザインの決定が「なぜ」なされたかが残っていないと、後から手を入れるのが本当に大変。「読んでわかる」ことはわざわざ別に書く必要はないので、「読んでもわからない/わかりにくい」ことを残してほしいもの。

[and_hyphen]

ドキュメントということばの使われ方の多様性が難しいと常々思っている。

[windish]

Unit Test を書く分の工数も下さい！先生！

[mumoshu]

fj.comp.oopsまで読んでしまった。こんな議論が10年も前に行われていたとは…

[kodaif]

"時間があるんだったら、テストを書こうよ。メンテされないドキュメントを書く時間があったらテストを書こうよ。テストを作った方が、気持ちいいし、楽だし、後々の工数を激減するし、何よりもいいリズムを生むよ。"

[t_43z]

大井町で飲みとか、事前に言ってくれれば参戦したのに！/そうか、楽天に移ったからうちの近所で飲む機会が実は多いのかな。