Jeffrey Palermo [MVP]

Software management consultant and CTO, Headspring Systems

Subversion presentation available on GoogleCode

I've shared a presentation on source code with Subversion on my GoogleCode. It covers how to use SVN for a project as well as recommendations for setting up the repository, tagging, and branching.

You can find it here:

svn co http://palermo.googlecode.com/svn/subversiondemo svndemo-trunk

Or if you just want the PPT, http://palermo.googlecode.com/svn/subversiondemo/trunk/Source%20Control%20fundamentals%20with%20Subversion.ppt

Published Sep 25 2007, 03:07 PM by Jeffrey Palermo

Comments

Sean Chambers said:

Jeff,

Excellent post! I wish I would have had this when I first started with subversion.

One thing I would like to add and tell me what you think of this. In the project root I have an additional folder "doc", to make a structure like this:

branches/

doc/

tags/

trunk/

In the doc folder I place photoshop files, word documents or any other files that pertain to the project but do not belong in the trunk. This way, if you have a number of very large psd files (for a recent cms I built) you don't have to branch/tag these files all over the place when you really don't need to.

I think it goes against the norm but I have found it to work well. What do you think?

# September 25, 2007 8:04 PM

Jeffrey Palermo said:

@Sean,

I wouldn't put docs at the root because you forfeit the ability to version the docs with the code. Perhaps you need to do a production bugfix and need to branch - the change requires a doc change - how do you change the docs? You can't just use the HEAD of the root because the docs describe features not yet released.

The concern about tagging and disk space is almost irrelevant. I've never tested SVN on tagging/branching size but SVN uses binary diffing for storage, so the repository size will not grow out of control.

I would put docs INSIDE the trunk.

# September 25, 2007 8:47 PM

About Jeffrey Palermo

Jeffrey Palermo is a software management consultant and the CTO of Headspring Systems in Austin, TX. Jeffrey specializes in Agile coaching and helps companies double the productivity of software teams. Jeffrey is an MCSD.Net , Microsoft MVP, Certified Scrummaster, Austin .Net User Group leader, AgileAustin board member, INETA speaker, INETA Membership Mentor, Christian, husband, father, motorcyclist, Eagle Scout, U.S. Army Veteran, and Texas A&M University graduate.