Wayne Werner  committed 3f0c863

Got a test up

  • Participants
  • Parent commits 9708fc9

Comments (0)

Files changed (3)

+syntax: glob
-# Welcome
+#Version Control
-Welcome to your wiki! This is the default page we've installed for your convenience. Go ahead and edit it.
+So, you heard about this fancy thing called "version control", eh? And it
+sounds a bit better than trying to email files back and forth, named
+my-super-awesome-thing-2013-08-26.txt, eh?
-## Wiki features
+Well then, you've come to the right place!
-This wiki uses the [Markdown]( syntax.
+I'm going to assume that you have *no knowledge* of programming, but that
+you're a least smart enough to know the difference between a monitor and a
+computer (unless you have an iMac. Or one of those all-in-one PCs.)
-The wiki itself is actually a mercurial repository, which means you can clone it, edit it locally/offline, add images or any other file type, and push it back to us. It will be live immediately.
+##What *is* Version Control?
-Go ahead and try:
+Version control is this fancy technology that programmers invented because
+programmers are lazy. This is why we write programs, so they can do our work
+for us. Especially tedious things, like taking two versions of a file and
+putting them together. Version control is exactly what it sounds like - it
+allows you to control the different versions of a file. You can think of them
+as snapshots. Or if you like to play a lot of video games like I do, you know
+how important it is to save your game. That way if you ever get totally
+destroyed by the mean ol' boss, you can just load up your game and try again.
+Version control works the same way, only instead of a boss battle, you're
+probably battling with some programming problem. But it *could* be something
+else. Like a [recipie]( Or this tutorial. Or some HTML.
+Really anything that is just plain ol' text.
-$ hg clone
+##A Quick Note: VCS/DVCS
-Wiki pages are normal files, with the .md extension. You can edit them locally, as well as creating new ones.
+You might occasionally hear about VCS or DVCS. These are Version Control
+Systems, and Distributed Version Control Systems. 
-## Syntax highlighting
+#Mercurial and TortoiseHg
+##What is Mercurial?
-You can also highlight snippets of text (we use the excellent [Pygments][] library).
+Mercurial is a *Distributed Version Control System*. Remember those save games
+I was talking about? If you're using a *Centralized Version Control System*
+(e.g. Subversion), when you click "save", your save game is actually stored on
+a main server somewhere. And if someone else wants to save their game, they
+better hope that everything the both of you have done so far matches up, or bad
+things might happen. With a DVCS, like Mercurial, you each save your games on
+your local machine. Then you can pass the saves back and forth and combine
+them, or share them to some other computer. It's pretty awesome.
+You'll frequently see Mercurial abbreviated as `hg`. Why Hg? Because that's the
+chemical symbol for Mercury. Programmers have such a weird sense of humour.
-Here's an example of some Python code:
-def wiki_rocks(text):
-    formatter = lambda t: "funky"+t
-    return formatter(text)
+In ye olden days of computing, we used these things called *terminals*. They
+were also nicknamed *shells*. I don't know why, but if I had to make up a
+reason, I'd say it's because they were a shell on top of your operating system.
+Remember that weird sense of humour? Well, turtles (tortoises) have *shells*.
+And TortoiseHg is also a shell over the command line/terminal/shell interface
+for Mercurial. Yeah, we really are that bad ;) (if you want a great
+introduction to Hg for the command line, go check out Joel Spolsky's tutorial
+at [](
+So this tutorial is an introduction to
+[TortoiseHg](, and how to use some of the
+more useful (but basic) features. The first thing you're going to want to do is
+go [download TortoiseHg](
+Installation should be straight forward if you're on Windows or Linux. Mac
+might be a [wee bit more
+difficult]( But it
+does look like either MacPorts or Homebrew might work without too much hassle.
-You can check out the source of this page to see how that's done, and make sure to bookmark [the vast library of Pygment lexers][lexers], we accept the 'short name' or the 'mimetype' of anything in there.
-Have fun!
+So, once you've got TortoiseHg installed, fire it up, and you should see
+![the main window](images/01-intro.png).

File images/01-intro.png

New image