アノテーションコメントについて調べてみたTODO ってなんだよ@phpstudy 2019/07/31 秋葉誠一
View Slide
自己紹介名前:秋葉 誠一生年月日:1993/12/17会社:株式会社ニジボックス趣味:スノボ、サバゲー、野球(NPB,MLB)@akki_megane
まず初めにアノテーションコメントとは?
まず初めにTODOFIXMEHACKXXX,REVIEW,OPTIMIZE,CHANGED,NOTE,WARNING
まず初めに
TODO とか、FIXME とかちゃんとつかえてないわー
TODO 、FIXME 以外にもあるよー(HACK, REVIEW)TODO とか、FIXME とかちゃんとつかえてないわー
TODO とか、FIXME とかちゃんとつかえてないわーTODO 、FIXME 以外にもあるよー(HACK, REVIEW)あっ、オレFIXMEの使い方間違えてた
まず初めにこれ誰が決めたの?
まず初めにこれ誰が決めたの?ということで調査
調査
調べたこと● 発案者● 原典● 公式定義、(Java、C#、PHP、Ruby、C++、Go)
調べたことコーディング規約Doc系の定義
結果
結果● 発案者:不明● 原典:不明● 公式定義:ちょっとあった
結果● 発案者:不明● 原典:不明● 公式定義:ちょっとあったRuby-style-guide に定義があった
自分の結論
● IEDが動作してるから、公式っぽい感じがするがそんなことはない● 原典的なものはないし、かくあるべきみたいなのもない● ネイティブの方たちが書いていたのが真似されて広まったのでは?と推測
まとめ
● こうでなければ、これは存在しないとか はない● プロジェクトやチームごとのすり合わせが大事○ (我々はネイティブではないので)
オレはこうだ!とかあればご意見お願いします!以上です!ありがとうございました!