アノテーションコメント

コメントにメタデータを付加するもの

コードの欠陥がわかりやすくなる

よく使われる記法と意味

a workaround.

a known bug that should be corrected.

コードをどのように変更したか。

a known bug that should be corrected.

既知の不具合があるコード。修正が必要。

should be corrected.

あまりきれいじゃないコード。リファクタリングが必要。

a workaround.

a workaround.

なぜ、こうなったという情報を残す。

used to highlight especially notable gotchas.

あとで追加、修正するべき機能がある。

something to be done.

a reversal or "roll back" of previous code.

注意が必要。

危険！動くけどなぜうごくかわからない。

warn other programmers of problematic or misguiding code