アカウント名:
パスワード:
必要なコメントをまるで書かずソースだけ書くスタイルと、ソースが更新されたのに、コメントの内容が古いままのスタイルだ
それに比べりゃアスタリスクの位置などなんだというのか
もっと許せないのは
//iに1を足すi++;
この手のは書いてる本人がよほどの暇人でないかぎりすぐに治るよ。
コメント書かない奴を矯正するのとは比較にならないほど楽。
//削除 start 2016.07.12//iに1を足す//削除 end 2016.07.12i++;
>//削除 start 2016.07.12>//iに1を足す>//削除 end 2016.07.12
これ、バージョン管理してるのにこれを書かないと気が済まない人ってマジでラリっちゃってるとしか思えないんだけど。誰が得するのこのコメント
ソースが読みにくいったりゃありゃしない
チェックイン時のコメントで全てまかなえるわけでもなく。上書きされまくって「いつ変わったのか」が分からなくなって、結局1つ1つ追いかけるハメになる。という苦労があって、バージョンつける(タグつける)段階で消すという運用でないと(時間的にも)やってられない状況になったことはある。
今?
SourceTreeおいしいれす。 (^ω^)※ そこまでの惨劇は稀なので、追いかけるストレスが減ればどうでもよくなった。
あるいは、
ちょっと前、確かgoogleの開発現場が「全部パッチで提供して、全体を把握する1人が入れる」みたいな感じのを目にした記憶があるのだが。今どうなのかね?
> 誰が得するのこのコメント
クライアントからの要請。
必ずしも納品先がバージョン管理してくれてるわけじゃない。差分が意図したものかわかるようにコメント入れろと言われるのはどこでもあること。
まあ慣例なのはわかるし、そういわれりゃやるんだけどさ…いつも思うんだが、俺らが読むの苦労するこのクソコメント付きソースが納品先で読めるのかね
#って思いながらZIPで固めてますよ、はい
むしろバージョン管理システムからエクスポートする時にこの記法にするプラグインがあればバカウケかも
コード読めないからそういう指示になるのさ。
ソース中のコメントとコミットは粒度が違うからな。
CVSからGitに変換して20年くらい履歴が残っているんだが、ログを追いかけてどの案件で変更したのか調べようとしても、時代によってコミットの粒度が変わっていくので大変なんだ。変更箇所のコメントにリリース年と案件名を入れておくのが確実。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
ナニゲにアレゲなのは、ナニゲなアレゲ -- アレゲ研究家
もっと許せないコメントスタイルはある (スコア:0)
必要なコメントをまるで書かずソースだけ書くスタイルと、
ソースが更新されたのに、コメントの内容が古いままのスタイルだ
それに比べりゃアスタリスクの位置などなんだというのか
Re: (スコア:0)
もっと許せないのは
//iに1を足す
i++;
Re: (スコア:0)
この手のは書いてる本人がよほどの暇人でないかぎりすぐに治るよ。
コメント書かない奴を矯正するのとは比較にならないほど楽。
Re: (スコア:0)
//削除 start 2016.07.12
//iに1を足す
//削除 end 2016.07.12
i++;
Re:もっと許せないコメントスタイルはある (スコア:1)
>//削除 start 2016.07.12
>//iに1を足す
>//削除 end 2016.07.12
これ、バージョン管理してるのにこれを書かないと気が済まない人って
マジでラリっちゃってるとしか思えないんだけど。誰が得するのこのコメント
ソースが読みにくいったりゃありゃしない
Re: (スコア:0)
Re: (スコア:0)
チェックイン時のコメントで全てまかなえるわけでもなく。
上書きされまくって「いつ変わったのか」が分からなくなって、結局1つ1つ追いかけるハメになる。
という苦労があって、バージョンつける(タグつける)段階で消すという運用でないと(時間的にも)やってられない状況になったことはある。
今?
SourceTreeおいしいれす。 (^ω^)
※ そこまでの惨劇は稀なので、追いかけるストレスが減ればどうでもよくなった。
あるいは、
ちょっと前、確かgoogleの開発現場が「全部パッチで提供して、全体を把握する1人が入れる」
みたいな感じのを目にした記憶があるのだが。今どうなのかね?
Re: (スコア:0)
> 誰が得するのこのコメント
クライアントからの要請。
Re: (スコア:0)
ソースが読みにくいのもそうだけどdiffも見にくくなるよね。
メソッド丸ごとコメントアウトしてるのとかホントにもう、勘弁して・・・。
Re: (スコア:0)
必ずしも納品先がバージョン管理してくれてるわけじゃない。
差分が意図したものかわかるようにコメント入れろと言われるのはどこでもあること。
Re: (スコア:0)
まあ慣例なのはわかるし、そういわれりゃやるんだけどさ…
いつも思うんだが、俺らが読むの苦労するこのクソコメント付きソースが
納品先で読めるのかね
#って思いながらZIPで固めてますよ、はい
Re: (スコア:0)
むしろバージョン管理システムからエクスポートする時にこの記法にするプラグインがあればバカウケかも
Re: (スコア:0)
コード読めないからそういう指示になるのさ。
Re: (スコア:0)
ソース中のコメントとコミットは粒度が違うからな。
CVSからGitに変換して20年くらい履歴が残っているんだが、ログを追いかけてどの案件で変更したのか調べようとしても、時代によってコミットの粒度が変わっていくので大変なんだ。
変更箇所のコメントにリリース年と案件名を入れておくのが確実。