アカウント名:
パスワード:
> そうですよね。なぜこのロジックを選択するに至ったか、もっとシンプルと> 思われる手法ではなにが問題だったかは長くなっても書いておくべきだと思います。
こういうことはコメントに書いてすませるべきではないですね。プログラム(マ)だけの問題ではありませんから、きちんと周知しレビューすべきです。
> コメントが必要ないのが綺麗なコードなんていうのは80年代で終わってますから。
80年代で終わっているのは君のおつむのほうで。
> こういうことはコメントに書いてすませるべきではないですね。> プログラム(マ)だけの問題ではありませんから、きちんと周知しレビューすべきです。
> 問題点はドキュメントに整理し、コメントはそこへのポインタを示すにとどめるべきです。> それ以上のコメントは有害です。
> 状況がどうなるかは誰にもわかりません。コメントやドキュメントは変化していく状況のためのものでもあります。> 例え今は自分しか見る人がいなくても、プログラマの言い訳は(書くのなら)コメントに長々と書くのではなくきちん> とドキュメント化すべきです。
「すべき」がやたらと多いけど、あなたは実践しているの?(周りの人にも実践させられるの?)結構大変だと思うけど。
> 状況がどうなるかは誰にもわかりません。そりゃその通りだけど・・・元コメを否定するほどの理由とは思えないな。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
アレゲは一日にしてならず -- アレゲ研究家
表現の範囲は把握しておく (スコア:4, すばらしい洞察)
なので、それらを総合的に合わせて一番適切な表現になる様にするのがベスト。
なぜそのコードが選ばれたのか?の意図はコードには表れない。
コードは自分が何かは表わすけど、それだけ。選択の意図するものが
最善なのか次善なのか、それともやっつけなのかわざとなのかはコードの記述範疇外だから。
Re: (スコア:1, 興味深い)
思われる手法ではなにが問題だったかは長くなっても書いておくべきだと思います。
ドキュメントは仕様を理解したらそんなに見ないですし。
コメントが必要ないのが綺麗なコードなんていうのは80年代で終わってますから。
Re: (スコア:0)
> そうですよね。なぜこのロジックを選択するに至ったか、もっとシンプルと
> 思われる手法ではなにが問題だったかは長くなっても書いておくべきだと思います。
こういうことはコメントに書いてすませるべきではないですね。
プログラム(マ)だけの問題ではありませんから、きちんと周知しレビューすべきです。
> コメントが必要ないのが綺麗なコードなんていうのは80年代で終わってますから。
80年代で終わっているのは君のおつむのほうで。
Re: (スコア:0)
もし周知させることが必要であっても、それはコメントの必要性と排他ではありません。
また、周知の必要性も状況によって変わりますから、必ずしなければならないものでもありません。
意見に補足するというコメントなら秀逸だったんだろうけど、
「それは間違いで俺の意見が正しい」みたいな方向に走ったのは間違いでしたね。
Re: (スコア:0)
問題点はドキュメントに整理し、コメントはそこへのポインタを示すにとどめるべきです。それ以上のコメントは有害です。
> また、周知の必要性も状況によって変わりますから、必ずしなければならないものでもありません。
状況がどうなるかは誰にもわかりません。コメントやドキュメントは変化していく状況のためのものでもあります。
例え今は自分しか見る人がいなくても、プログラマの言い訳は(書くのなら)コメントに長々と書くのではなくきちんとドキュメント化すべきです。
Re:表現の範囲は把握しておく (スコア:0)
> こういうことはコメントに書いてすませるべきではないですね。
> プログラム(マ)だけの問題ではありませんから、きちんと周知しレビューすべきです。
> 問題点はドキュメントに整理し、コメントはそこへのポインタを示すにとどめるべきです。
> それ以上のコメントは有害です。
> 状況がどうなるかは誰にもわかりません。コメントやドキュメントは変化していく状況のためのものでもあります。
> 例え今は自分しか見る人がいなくても、プログラマの言い訳は(書くのなら)コメントに長々と書くのではなくきちん
> とドキュメント化すべきです。
「すべき」がやたらと多いけど、あなたは実践しているの?(周りの人にも実践させられるの?)
結構大変だと思うけど。
> 状況がどうなるかは誰にもわかりません。
そりゃその通りだけど・・・元コメを否定するほどの理由とは思えないな。
Re: (スコア:0)
していますし、実は周りの人に実践させられました。
> 結構大変だと思うけど。
あなたもバージョン管理システムでドキュメントを管理するでしょう?
何がどう大変だと思ったのですか?
> そりゃその通りだけど・・・元コメを否定するほどの理由とは思えないな。
いえ、本質は
・長すぎるコメント(特にプログラマの言い訳)はドキュメントにして別に管理すべき
ということです。
何か長いものを書くとして、どうしてそれがソースコード中でなければならないのですか?