[webkit-dev] Comments in the code (Was Please include function-level comments in change log entries)
per.bothner at oracle.com
Fri Jul 6 20:35:10 PDT 2012
On 07/06/2012 08:23 PM, Ryosuke Niwa wrote:
> Again: Differing cultures
> Indeed. You just need to get used to it.
"The reasonable man adapts himself to the world; the unreasonable one
persists in trying to adapt the world to himself. Therefore, all
progress depends on the unreasonable man." --G. B. Shaw
However, I don't feel strongly enough about WebKit to be
unreasonable about it :-)
> *And please, please go read webkit-dev archives before continuing
> the discussion*. I suspect there are many contributors who are
> ignoring this thread because we have this discussion every six
> months or so, and they're getting tired of it. I'm getting tired of
> it as well.
I've been subscribed to webkit-dev since March 2011, and I don't
remember such a discussion. I could have missed it; webkit is somewhat
on the periphery of my interests.
These all seem to be about ChangeLogs or commit messages. Thus
irrelevant to my point (which a number of people have agreed with)
that class-level comments are often be useful and should be encouraged
rather than discouraged (on a case-by-case basis, assuming they say
Regardless, I've said my piece. and have no interest in continuing.
per.bothner at oracle.com per at bothner.com http://per.bothner.com/
More information about the webkit-dev