[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: [PATCH] issue#2317 - Problem with Peg Revisions for filescontaining '@' - V2

From: Julian Foad <julianfoad_at_btopenworld.com>
Date: 2005-07-05 23:53:27 CEST

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?

- Julian

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Wed Jul 6 00:56:42 2005

This is an archived mail posted to the Subversion Dev mailing list.