Apr 29 2024 17 mins 4
■ トピック
- 「コメントをちゃんと書きましょう」
- コードの日本語訳のようなコメントは消してほしい
- 良くないコメントがあるよりは無い方がマシ
- コメントを書かないでいいようなコードを書きたい
- 「何を書いてはいけないのか」がわからないといけない
- コードスメル、消臭剤としてのコメント
- 情報として有益であっても消されるべきコメント
- 申し訳なさとともにコメントを書く
- 交通標識のように機能するコメント
- 読まれるべきコメントへの注意を引くためにはS/N比が大事
■ 参考リンク
- O'Reilly Japan - リーダブルコード
- エンジニアのためのドキュメントライティング - JMAM 日本能率協会マネジメントセンター
- リファクタリング（第2版） 既存のコードを安全に改善する | Ohmsha
■ おたよりフォーム
https://forms.gle/RYUG7T4ctmF7Srf36
■ X（Twitter）
https://twitter.com/refactoradio
ハッシュタグは #リファラジ です。
