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

Re: subversion guideline

From: William Nagel <bill_at_stagelogic.com>
Date: 2005-07-28 16:49:04 CEST

Hi Martin,

Nice job. Very concise. Looks good. Lots of info. I do have a
couple of suggestions, though.

1) Commit, point #2: 'hindered' is misspelled as hintered
2) I'm not so sure about the prefixes. I can see their usefulness,
but I think they may encourage a tendency to use them as a crutch,
which may lead to less useful text describing what was done, which
leads me to
3) Your sample commit message doesn't seem to be very descriptive.
It tells what was done, but doesn't say why it was done, which is
often much more useful. It also doesn't seem to follow your own
advice. It appears that there are two (at least) conceptual changes
involved in the example commit message.

Overall though, it looks pretty good. There are a lot of legitimate
reasons for individual projects to do things differently than you
describe, but for general best practices they seem to be good advice.

-Bill

On Jul 28, 2005, at 4:51 AM, Martin Ankerl wrote:

> Hi everyone,
>
> I have compiled a (very very short) subversion guideline from various
> sources. You can get it here:
>
> http://martinus.geekisp.com/files/subversion/SubversionGuideline.doc
> or in other formats:
> http://martinus.geekisp.com/files/subversion/SubversionGuideline.ps
> http://martinus.geekisp.com/files/subversion/SubversionGuideline.pdf
>
> Suggestions welcome!
>
> --
> Martin Ankerl | http://martinus.geekisp.com/
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
> For additional commands, e-mail: users-help@subversion.tigris.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@subversion.tigris.org
For additional commands, e-mail: users-help@subversion.tigris.org
Received on Thu Jul 28 16:52:51 2005

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