SC2012BootcampPlan » History » Version 9
Version 8 (Chris Cannam, 2012-04-24 02:22 PM) → Version 9/83 (Chris Cannam, 2012-04-24 02:23 PM)
h1. Plan for Software Carpentry 2012 Boot Camp on Version Control
h3. Purpose
To explain version control to researchers who have never used it before, or who want to understand it better.
h3. Context
Two hour interactive live workshop, using EasyMercurial and the Mercurial command-line tool.
h2. Outline
The basic plan is:
# presentation introduction to version control in general (using either whiteboard drawings or a PowerPoint presentation)
# long worked example in which basic topics of version control are worked through using EasyMercurial and then some more advanced topics are returned to using the command-line tool
# closing remarks talking about other tools, other topics of interest etc
Detailed outline:
* A presentation introduction to the concept of version control.
** What is it for and why is it useful?
** What can go wrong without it?
** How does a version control system work?
** *History* + *Collaboration*
* Check that participants have EasyMercurial installed and working
* *Worked example, part 1: Working by myself*
** *Topics:* Initialising a repository, committing files, reading history, looking at diffs, reverting unwanted changes, going back in time to look at old versions
** We will be working on a recipe for fish stew for a future recipe book
** Make a new directory, create a text file @fishstew.txt@ in it, start adding an ingredients list, save
** Run up EasyMercurial, "Open" that directory, see @fishstew.txt@ in untracked file list, explain this
** Add file, commit, supply a message, note that we now have some history
** Make a change, note that files are marked as modified, note possible presence of backup file (ending ~ or .bak) from editor -- _we'll come back _digression on adding to that_ ignore list_
** Commit change, review history, look at the diff
** _Digression: every action we're taking here corresponds to one command-line command: show hg log, hg diff etc_
** Go back to that backup file in My Work, add it to ignored list
h3. Purpose
To explain version control to researchers who have never used it before, or who want to understand it better.
h3. Context
Two hour interactive live workshop, using EasyMercurial and the Mercurial command-line tool.
h2. Outline
The basic plan is:
# presentation introduction to version control in general (using either whiteboard drawings or a PowerPoint presentation)
# long worked example in which basic topics of version control are worked through using EasyMercurial and then some more advanced topics are returned to using the command-line tool
# closing remarks talking about other tools, other topics of interest etc
Detailed outline:
* A presentation introduction to the concept of version control.
** What is it for and why is it useful?
** What can go wrong without it?
** How does a version control system work?
** *History* + *Collaboration*
* Check that participants have EasyMercurial installed and working
* *Worked example, part 1: Working by myself*
** *Topics:* Initialising a repository, committing files, reading history, looking at diffs, reverting unwanted changes, going back in time to look at old versions
** We will be working on a recipe for fish stew for a future recipe book
** Make a new directory, create a text file @fishstew.txt@ in it, start adding an ingredients list, save
** Run up EasyMercurial, "Open" that directory, see @fishstew.txt@ in untracked file list, explain this
** Add file, commit, supply a message, note that we now have some history
** Make a change, note that files are marked as modified, note possible presence of backup file (ending ~ or .bak) from editor -- _we'll come back _digression on adding to that_ ignore list_
** Commit change, review history, look at the diff
** _Digression: every action we're taking here corresponds to one command-line command: show hg log, hg diff etc_
** Go back to that backup file in My Work, add it to ignored list