Attached is the patch of everything I have thus far. Additional changes needed is
the feedback from paulproteus and the ability to serve the repository. The URL
for checkout will need to be updated in the template, as it currently says to use
the git method of pulling the repo, rather than http.
Feedback from paulproteus. (note it was later decided that a specific bash/editor
mission was probably more suited to teaching those skills than the git mission
would be.)
* Second page: You're asking people to read the code comments to find the author
of something, but that's confusing because "git log" and "git annotate" (AKA "git
blame") are the more common tools for finding the author of some code. Maybe you
could ask them to do something different, like paste the output of the program?
Also, people have suggested we explain to people they need to "cd" into a
directory, or open a particular file with a text editor -- whatever you ask
people to do, it should only be unclear if that's what you want. We can't
necessarily assume much of the skill level of people running through these
missions.
* Third page: I would link to the diff/patch mission in the text, and also have a
paragraph like:
"Files created by git format-patch are like normal patch files, but they also
carry information about the git commit that created the patch: the author, the
date, and the commit log message are all there at the top of the patch."
Also, you don't explain here how to "check your changes into your local copy".
Also, if the person is an OS X user, we could suggest they creating the
patch with GitX, or with gitg in GNU/Linux-y systems.
Also, "open the patch file" in what?
|