タグ

2009年11月7日のブックマーク (1件)

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

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

    無駄なドキュメントは書くな(再考)@大井町の飲み屋談義 - 未来のいつか/hyoshiokの日記
    yukinarian0
    yukinarian0 2009/11/07
    デザインの決定が「なぜ」なされたかが残っていないと、後から手を入れるのが本当に大変。「読んでわかる」ことはわざわざ別に書く必要はないので、「読んでもわからない/わかりにくい」ことを残してほしいもの。