アカウント名:
パスワード:
アノテーションコメントTODOを使うのがマナーだと思うのだけど?
勝手なオレオレコメント様式が許される環境のようだから別に良いのだけど、プログラムを組むのが仕事の一環としてあるなら、一般的なアノテーション [qiita.com]は押さえておくべき。
TODO:は残す場合に使って、@@@は原則後で消します。
極論を言えば今この瞬間に寿命で死ぬかもしれないのだから、引継ぎも想定し「メタデータとしてきちんと抽出できる様式」に従うことをお奨めします。
#TODOアノテーションにして、そのコメントを@@@+コメントにすればイイじゃん
そもそも自分の周りの客先(大手含む)ではTODOアノテーション自体が使われてないし、VisualStudioも最近のは何だか無視するようになってきてるような感じ。
そもそも作成者が途中で死んだような未完成のソースをアノテーションのところしか見ない姿勢は間違いだろう。
なんだか見苦しいですよ。「オレオレコメント様式はいかがなものか?」って話の本質から逃げようと必死な感じ。
素直に「改めます」で良いのに、お前のそういうとこだぞ。
そう言えばそういうパターンもある。勘違いしているようだが、@@@はアノテーションではなく単なるブックマーク。
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
私は悩みをリストアップし始めたが、そのあまりの長さにいやけがさし、何も考えないことにした。-- Robert C. Pike
アノテーション (スコア:0)
アノテーションコメントTODOを使うのがマナーだと思うのだけど?
勝手なオレオレコメント様式が許される環境のようだから別に良いのだけど、プログラムを組むのが仕事の一環としてあるなら、一般的なアノテーション [qiita.com]は押さえておくべき。
Re:アノテーション (スコア:2)
TODO:は残す場合に使って、@@@は原則後で消します。
Re: (スコア:0)
極論を言えば今この瞬間に寿命で死ぬかもしれないのだから、引継ぎも想定し「メタデータとしてきちんと抽出できる様式」に従うことをお奨めします。
#TODOアノテーションにして、そのコメントを@@@+コメントにすればイイじゃん
Re:アノテーション (スコア:2)
そもそも自分の周りの客先(大手含む)ではTODOアノテーション自体が使われてないし、VisualStudioも最近のは何だか無視するようになってきてるような感じ。
Re:アノテーション (スコア:2)
そもそも作成者が途中で死んだような未完成のソースをアノテーションのところしか見ない姿勢は間違いだろう。
Re: (スコア:0)
なんだか見苦しいですよ。
「オレオレコメント様式はいかがなものか?」って話の本質から逃げようと必死な感じ。
素直に「改めます」で良いのに、お前のそういうとこだぞ。
Re:アノテーション (スコア:2)
そう言えばそういうパターンもある。
勘違いしているようだが、@@@はアノテーションではなく単なるブックマーク。