Julian Foad <julianfoad@btopenworld.com> writes:
> kfogel@collab.net wrote:
> > Alexander, perhaps this meta-explanation will help with log messages:
> > The intended audience is a Subversion developer who is not familiar
> > with the change. Usually when someone goes back and reads a change
> > (which happens surprisingly frequently), they no longer have in their
> > head all the context around that change. They've forgotten the mails
> > about it, the issue, the code discussions, etc. It could be six
> > months later and they're porting it to a release branch and need to
> > review it, or something like that.
> > Your log message is the introduction to the change. Write it for an
> > experienced Subversion developer who is starting with no particular
> > knowledge of what this change is about, but who knows Subversion in
> > general.
>
> Karl, you are good at saying these kinds of things. It would be nice
> to be able to point people at some existing explanation each time,
> rather than trying to re-explain it each time. Therefore could you
> perhaps add the above to the "Writing log messages" secion of HACKING?
Okay, I've tried to do this in r15270. Further tweaks welcome!
-Karl
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Jul 6 05:13:22 2005