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