version-control/instructor.md: Add a 'Tool choices' section
authorW. Trevor King <wking@tremily.us>
Wed, 23 Oct 2013 04:15:03 +0000 (21:15 -0700)
committerW. Trevor King <wking@tremily.us>
Wed, 23 Oct 2013 04:25:57 +0000 (21:25 -0700)
Software Carpentry is about how to develop software, which is largely
independent of the tooling for a particular task.  This branch only
contains the generic motivation and introduction for version control.
That's nice, but a particular Software Carpentry course or boot camp
*is* going to want to teach a specific tool, and we want instructors
to easily be able to find and integrate notes for the tool they
choose.

This setup doesn't assume that there is a single canonical set of
notes for a given tool.  If you don't like the branches I've listed,
write up your own.  If you tell me about it, I'll add a link to your
branch as well, and we can try and work up some short descriptions to
help new instructors differentiate between the two approaches.

The choices are in the format used by `git request-pull`, so you can
run:

  $ git merge $CHOICE

to merge the branch.  For example:

  $ git merge git://github.com/wking/swc-boot-camps.git version-control-git

without bothering to setup remotes, etc.

version-control/instructor.md

index 78f16f0d09e74a473b73b96c0ab6790844868572..6dd826cd9a261ab5eeb5b28957c82d5acfb9c3df 100644 (file)
@@ -6,8 +6,24 @@ changes upstream and why that's a good way to structure development.
 Provided there aren't network problems, this entire lesson can be
 covered in 90 minutes.
 
+Tool choices
+============
+
+There are many version control tools available, and we have Software
+Carpentry branches for some of them.  Possible choices:
+
+Git
+---
+
+* `git://github.com/wking/swc-boot-camps.git version-control-git`
+
+Subversion
+----------
+
+* `git://github.com/wking/swc-boot-camps.git version-control-svn`
+
 Teaching notes
---------------
+==============
 
 * Make sure the network is working *before* starting this lesson.