パスワードを忘れた? アカウント作成
この議論は賞味期限が切れたので、アーカイブ化されています。 新たにコメントを付けることはできません。

プログラマーにドキュメントを書かせるには?」記事へのコメント

  • (一切、邪魔されない) ドキュメント書く工数を入れてくれ。
    そもそも開発の途中でドキュメントと合わなくなってしまう現象があるなら
    当然工数の最後に「ドキュメント書き直し期間」が含まれてなきゃダメなんじゃないか?

    結局、開発工数の中に溶けこまそうと無理させているんじゃないか。
    開発止めて、ドキュメント作りなおしてから開発再開ってところもあったけど、1度しか経験がない。
    大体「議事録にあったはず・・・」とか「イツイツそういう話が出てきた・・・」とかそんな話になってる。

    ついでに。
    関係者と話していて、「あ。この話ブレそうだな」とか「相手が協力的な態度じゃないな」と思うと
    ドキュメント書くの一気に萎えません? 私は萎えます。

    --
    ==========================================
    投稿処理前プレビュー確認後書込処理検証処理前反映可否確認処理後……
    • by Anonymous Coward
      >関係者と話していて、「あ。この話ブレそうだな」とか「相手が協力的な態度じゃないな」と思うと
      >ドキュメント書くの一気に萎えません? 私は萎えます。

      私の場合は逆にドキュメントをきっちり書いて、ドキュメントの通りで問題がないか念を押して確認したくなります。後で違うことを言われてもこちらの責任にならないように。
      • 責任うんぬんとは別ですね。
        そういうブレブレになっている場合は、
        仕様書や設計書に取り込まれずに、別に作られていたりするんですよ。

        そう。「懸念事項確認一覧」とかね。
        しかも分かりにくい階層に放り込まれてたり。

        それを、すぐにドキュメントに反映させられないのは、何故かって話です。
        懸念事項確認一覧なんて表をやめて、BTSに入れとくって人も居るでしょうし
        私の場合は、最後に総点検する時間が欲しいと思ってるわけです。

        --
        ==========================================
        投稿処理前プレビュー確認後書込処理検証処理前反映可否確認処理後……
        親コメント

海軍に入るくらいなら海賊になった方がいい -- Steven Paul Jobs

処理中...