タグ

開発とドキュメントに関するstuonsのブックマーク (1)

  • わたしが知らないスゴ本は、きっとあなたが読んでいる: ウォーターフォールはこう使え(その5)

    ウォーターフォールの怨嗟の的になっているのは「ドキュメント」だろう。使うかどうかも分からぬような大量のドキュメントを書かされる。しかも顧客の一言で大幅に書き直しを命ぜられる。さもありなん。だが、ここでは、ウォーターフォール・モデルにおけるドキュメントの必要性を強調する。 ドキュメント=契約書 なぜドキュメント化が嫌われるのか? SEの立場から言うと、ちゃんと検討していないまま、「とりあえず」ドキュメント化をさせられるから(結果、後から手直しが多発する)だろう。PGの立場からすると、理解してコードに落とすだけの内容を、なぜ語弊の出る日語に書き直さなければならないか、疑問に思うだろう。 当の問題はSE/PGがドキュメントを書いていること。あるいは、片手間にドキュメントを書いていることをなんとかすべき。来なら専門部隊を準備するか、リソースを明示的に割り当て、執筆期間を設ける必要がある。 こ

    わたしが知らないスゴ本は、きっとあなたが読んでいる: ウォーターフォールはこう使え(その5)
  • 1