https://b.hatena.ne.jp/entry/s/www.turtlewalk.org/blog/2012/07/07/webkit-source-code-comment-1/ WebKit 開発者のメーリングリスト webkit-dev を見ていたら、興味深い話題で盛り上がっていた。WebKit のソースコードや ChangeLog のコメントに関する議論だ。 WebKit に限らず、ハッカーというのはソースコード... https://b.hatena.ne.jp/techtech0521/20240111#bookmark-4686856968889032354 2024-01-11T04:25:43Z あとで読む https://b.hatena.ne.jp/roshi/20170217#bookmark-321793580 インセンティブとかコメントが古くなるとか理由が謎すぎる。。分かりやすい名前をつける、コメントが間違ってたら直すまでを含めて”コーディング”だと思うけどなー。 2017-02-16T15:57:47Z https://b.hatena.ne.jp/lugecy/20170214#bookmark-321793580 2017-02-14T11:08:58Z programming stars https://b.hatena.ne.jp/yyamano/20170214#bookmark-321793580 2017-02-14T05:59:00Z https://b.hatena.ne.jp/t-wada/20170214#bookmark-321793580 API ドキュメントと CHANGELOG 、テストコードはもちろん書くとして、コード内には「あえてやっていること/やっていないこと」だけをコメントに書くのが良いと考えています 2017-02-14T05:11:03Z programming https://b.hatena.ne.jp/rti7743/20170214#bookmark-321793580 changelogってcommit logとか元に自動生成できないもんかな。みんな大好きV8エンジンのchangelogなんて Performance and stability improvements on all platforms. しか書いてなくて面白いぞ。 https://github.com/v8/v8/blob/master/ChangeLog 2017-02-13T17:20:04Z https://b.hatena.ne.jp/hiroomi/20170214#bookmark-321793580 2017-02-13T15:36:10Z https://b.hatena.ne.jp/t_mori/20170214#bookmark-321793580 2017-02-13T15:06:03Z https://b.hatena.ne.jp/tbpg/20170213#bookmark-321793580 "コメントが間違っていてもコンパイラはチェックしないから、誰も直そうというモチベーションにならない" 2017-02-13T13:17:13Z https://b.hatena.ne.jp/mfham/20170213#bookmark-321793580 2017-02-13T12:52:30Z プログラミング コメント https://b.hatena.ne.jp/akabekobeko/20170213#bookmark-321793580 xDoc 系ツールで API リファレンス生成されることを想定しインターフェースに対して書く。意図や目的について書いているならコード変更の影響は受けないし意図や目的が変わったならコメントも修正すべきという考え。 2017-02-13T12:50:04Z https://b.hatena.ne.jp/nakag0711/20170213#bookmark-321793580 「コメントを書かなくて済むような綺麗なコード」そう思っているのはコードを書いた本人だけ 2017-02-13T11:47:48Z https://b.hatena.ne.jp/manabou/20170213#bookmark-321793580 2017-02-13T09:24:11Z webkit source comment https://b.hatena.ne.jp/komlow/20170213#bookmark-321793580 2017-02-13T09:16:11Z programming https://b.hatena.ne.jp/somathor/20170213#bookmark-321793580 2017-02-13T08:18:00Z webkit code-review https://b.hatena.ne.jp/otsune/20170213#bookmark-321793580 2017-02-13T07:32:44Z https://b.hatena.ne.jp/peketamin/20170213#bookmark-321793580 2017-02-13T07:32:39Z https://b.hatena.ne.jp/Hiro_Matsuno/20170213#bookmark-321793580 2017-02-13T07:18:58Z https://b.hatena.ne.jp/Horiuchi_H/20170213#bookmark-321793580 コメント議論については、結局堂々巡りだな。自分も基本的にコメントは書かなくなった。 2017-02-13T05:22:48Z programming 議論 https://b.hatena.ne.jp/slay-t/20170213#bookmark-321793580 2017-02-13T05:11:07Z webkit programming development プログラミング テクノロジー https://b.hatena.ne.jp/mieki256/20170213#bookmark-321793580 2017-02-13T04:30:58Z programming https://b.hatena.ne.jp/masa-wo/20170213#bookmark-321793580 2017-02-13T03:44:51Z https://b.hatena.ne.jp/motchang/20170213#bookmark-321793580 2017-02-13T03:09:52Z programming https://b.hatena.ne.jp/Haaaa_N/20170213#bookmark-321793580 webkitはまず膨大なコードの量をどうにか減らせないんですかね 外部ライブラリ化するとか 2017-02-13T02:53:15Z https://b.hatena.ne.jp/labocho/20170213#bookmark-321793580 2017-02-13T02:52:49Z https://b.hatena.ne.jp/mooonymann/20170213#bookmark-321793580 2017-02-13T02:35:24Z https://b.hatena.ne.jp/at_yasu/20170213#bookmark-321793580 2017-02-13T01:39:42Z https://b.hatena.ne.jp/mugichan3/20170213#bookmark-321793580 2017-02-13T01:06:38Z https://b.hatena.ne.jp/k2k2monta/20170213#bookmark-321793580 2017-02-13T00:45:26Z あとで読む https://b.hatena.ne.jp/writers-high/20170213#bookmark-321793580 2017-02-13T00:19:14Z あとで読む https://b.hatena.ne.jp/atsumo/20170213#bookmark-321793580 2017-02-13T00:03:38Z webkit programming https://b.hatena.ne.jp/clavier/20170213#bookmark-321793580 2017-02-13T00:00:18Z https://b.hatena.ne.jp/fujihiro0/20170213#bookmark-321793580 2017-02-12T23:59:49Z https://b.hatena.ne.jp/adwd118/20170213#bookmark-321793580 なるべく書かないけどコードに表せないこと（実装の意図とか）はちゃんと書く感じなのかな 2017-02-12T23:52:58Z https://b.hatena.ne.jp/gfx/20170213#bookmark-321793580 どこも同じだな…。 2017-02-12T23:47:22Z https://b.hatena.ne.jp/ryamamoto/20170213#bookmark-321793580 2017-02-12T23:19:08Z https://b.hatena.ne.jp/advblog/20170213#bookmark-321793580 2017-02-12T23:08:30Z https://b.hatena.ne.jp/wizluck/20170213#bookmark-321793580 2017-02-12T22:59:48Z https://b.hatena.ne.jp/zetta1985/20170213#bookmark-321793580 2017-02-12T22:37:03Z https://b.hatena.ne.jp/fumikony/20170213#bookmark-321793580 2017-02-12T22:15:50Z あとで読む https://b.hatena.ne.jp/nfunato/20170213#bookmark-321793580 2017-02-12T20:39:39Z programming https://b.hatena.ne.jp/ohnishiakira/20170213#bookmark-321793580 2017-02-12T19:04:14Z https://b.hatena.ne.jp/Watson/20170213#bookmark-321793580 2017-02-12T17:56:06Z development programming https://b.hatena.ne.jp/mapk0y/20170213#bookmark-321793580 2017-02-12T16:53:54Z development https://b.hatena.ne.jp/netcraft3/20170213#bookmark-321793580 2017-02-12T16:39:15Z https://b.hatena.ne.jp/kazufsaf/20170213#bookmark-321793580 2017-02-12T16:26:12Z https://b.hatena.ne.jp/bekkyonotatujin/20170212#bookmark-321793580 2017-02-12T14:32:03Z https://b.hatena.ne.jp/Jxck/20170212#bookmark-321793580 2017-02-12T13:54:47Z WebKit https://b.hatena.ne.jp/azumaon/20170212#bookmark-321793580 2017-02-12T13:51:47Z 話題 https://b.hatena.ne.jp/chitoku_k/20170212#bookmark-321793580 2017-02-12T13:33:05Z https://b.hatena.ne.jp/clngn/20170212#bookmark-321793580 “「コメントは書くべきでない」という文化があることで、それがプレッシャーになって、クラス名について一生懸命考える。それによって、良くない設計に気付いて見直したりすることもある。” 2017-02-12T13:27:29Z javascript development https://b.hatena.ne.jp/cubicdaiya/20170212#bookmark-321793580 2017-02-12T12:20:59Z https://b.hatena.ne.jp/mizchi/20170212#bookmark-321793580 2017-02-12T12:17:41Z