Re: Changelogs on kernel.org

Larry McVoy
2002-05-13T05:17:54Z

On Mon, May 13, 2002 at 01:10:06AM -0400, Jeff Garzik wrote:
> (speaking more to the crowd...)
> Changeset comments need to be written as if they stand alone, without
> any other context -- including the author. A reader should not need to
> know that (for examples) James Simmons hacks on fbdev stuff.

100% agreed.

Part of the design of citool was an attempt to guide people towards
doing that. We encourage people to do the detailed stuff on the file
comments and the logical level comment on the changeset. Think of file
as the "how" and the changeset as the "what".

The good news is that people do tend to get better once they realize
that other people read this stuff.
--
---
Larry McVoy lm at bitmover.com http://www.bitmover.com/lm