アカウント名:
パスワード:
ここでドキュメントは要らないって言ってる人達はソース中にコメントも書かない人なんだろうか。
コメントを書くのだって同じ内容を別の言語で重複して記述することに違いないと思うんだけど。
もしコメントを書いてるんだったら、それと同じ理由でドキュメントを書く価値があるんじゃないの？
＞ここでドキュメントは要らないって言ってる人達はソース中にコメントも書かない人なんだろうか。
逆、逆。ソース中にコメント等で書いてあるから、(同じことを書いた)設計書はいらないと言っている。
拡大解釈して「ソース中にあらゆることが書いてあるからソース以外のドキュメントは一切不要」と思っている人も中にはいるかもしれないけれど、多くの人はソースだけで示せないことについて別立てでドキュメントを作ることは否定していないと思う。
それならコメントをなくしてドキュメントとしてまとめた方がいいかもよ？処理の概要や背景を書く場合、思いつきで散発的に書かれたコメントよりはドキュメントとしてまとめた方が説明しやすいだろうし。
メンテナンス性に関してはコメントも途中で整合性なくなるのはよくあることなのでドキュメントと対して変わらないと思うよ。
１）「いわゆるドキュメントにまとめる」：図を駆使したりおそらく表現力は豊か。でもメンテは控えめに言って大変。はっきり言えば悪夢。
２）「イシュー追跡システムにまとめる」：ツールが整備されてるのでたぶんメンテは楽。手続きとして開発作業に組み込まれるのでメンテ放棄の状態にはなりにくい。お客に出すなら別途作業が必要。
で、１）か２）のどちらを選ぶかが分かれ目になるんじゃないかな。ちなみに自分は２）。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
吾輩はリファレンスである。名前はまだ無い -- perlの中の人
コメントも書かない？ (スコア:0)
ここでドキュメントは要らないって言ってる人達はソース中にコメントも書かない人なんだろうか。
コメントを書くのだって同じ内容を別の言語で重複して記述することに違いないと思うんだけど。
もしコメントを書いてるんだったら、それと同じ理由でドキュメントを書く価値があるんじゃないの？
Re: (スコア:0)
＞ここでドキュメントは要らないって言ってる人達はソース中にコメントも書かない人なんだろうか。
逆、逆。
ソース中にコメント等で書いてあるから、(同じことを書いた)設計書はいらないと言っている。
拡大解釈して「ソース中にあらゆることが書いてあるからソース以外のドキュメントは一切不要」と
思っている人も中にはいるかもしれないけれど、多くの人はソースだけで示せないことについて
別立てでドキュメントを作ることは否定していないと思う。
Re:コメントも書かない？ (スコア:0)
それならコメントをなくしてドキュメントとしてまとめた方がいいかもよ？
処理の概要や背景を書く場合、思いつきで散発的に書かれたコメントよりはドキュメントとしてまとめた方が説明しやすいだろうし。
メンテナンス性に関してはコメントも途中で整合性なくなるのはよくあることなのでドキュメントと対して変わらないと思うよ。
Re: (スコア:0)
１）「いわゆるドキュメントにまとめる」：
図を駆使したりおそらく表現力は豊か。でもメンテは控えめに言って大変。はっきり言えば悪夢。
２）「イシュー追跡システムにまとめる」：
ツールが整備されてるのでたぶんメンテは楽。手続きとして開発作業に組み込まれるのでメンテ放棄の状態にはなりにくい。お客に出すなら別途作業が必要。
で、１）か２）のどちらを選ぶかが分かれ目になるんじゃないかな。
ちなみに自分は２）。