Re: svn commit: rev 5449 - trunk/subversion/tests/clients/cmdline

Ben Collins-Sussman <sussman@collab.net> writes:
> Yes. There are basically 3 depth levels that (I suspect) most people
> have when reading a commit mail:
>
> 1. look for a sentence or paragraph that explains what the change is
> about.
>
> 2. if still interested, read about the symbols changed.
>
> 3. if still interested, read the diffs.
>
> It's important for people to be able to "bail out" after the first
> depth level, so it needs to exist. :-)

I should confess that I've written log message like Matt's before,
too, so I hope I don't sound *too* preachy :-). However, I'm now
trying to always write a summary blurb, the only exceptions being when
there's just one place changed -- then the blurb and the technical
description are one and the same.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Mar 25 20:53:16 2003