エントリーの編集
エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。
エントリーの編集は全ユーザーに共通の機能です。
必ずガイドラインを一読の上ご利用ください。
注目コメント算出アルゴリズムの一部にLINEヤフー株式会社の「建設的コメント順位付けモデルAPI」を使用しています
会社のとあるプロジェクトでコーディングの可読性に関する勉強会を実施してるらしい。 そのプロジェクト... 会社のとあるプロジェクトでコーディングの可読性に関する勉強会を実施してるらしい。 そのプロジェクトはリリースは終わって保守に移行してんだけど今更そこ勉強してんのって感じが半端ない。新人向けか? そのプロジェクトはもちろん炎上しまくってた。今も炎上してると思う。 さて、その勉強会の資料を見る機会があってだいたいはごくごく当たり前のことを書いてた。メソッドの行数とかそういうの。 でも資料の中にコメントを書けっていう項目があってJavadocを書けって言う項目がなかったのに驚きを隠せなかった。 コメントなんかよりJavadocの方が大事なんだってことがわかってないみたい。 というか、そのプロジェクトではJavadocを書かない主義だったらしい。全く意味がわからない。恐ろしい。。。 と、前置きが長くなってしまったが、 コメントを書くよりJavadoc(privateメソッドも含む)を書く方がいいん