Modified:
/wiki/Source.wiki
=======================================
--- /wiki/Source.wiki Wed Mar 9 11:56:28 2011
+++ /wiki/Source.wiki Wed Mar 9 12:31:14 2011
@@ -1,8 +1,10 @@
-=The Khan Academy source is stored in Mercurial and hosted on Kiln.=
+==The Khan Academy source is stored in Mercurial and hosted on Kiln.==
All of our code is available in the repositories at
https://khanacademy.kilnhg.com
-==To clone our primary repository:==
+----
+
+=To clone our primary repository:=
Anybody may clone our repositories anonymously.
@@ -10,7 +12,7 @@
2. You'll need Kiln credentials to push any changes.
-===Command line client===
+*Using the command line:*
You can install the basic Mercurial command line client from
http://mercurial.selenic.com.
@@ -18,9 +20,9 @@
`hg clone https://khanacademy.kilnhg.com/Repo/Website/Group/stable
khanacademy-stable`
-...expect this to take a long time the first time you run it.
-
-===Graphical clients===
+...expect this to take a long time the first time you run
+
+*Using a graphical client:*
If you prefer, you can use any graphical Mercurial client instead of the
command line.
@@ -30,10 +32,28 @@
For Mac/Unix users, we recommend [http://jasonfharris.com/machg MacHg],
[http://jens.mooseyard.com/2009/04/murky-a-mercurial-client-app Murky], or
[http://www.sourcetreeapp.com/home SourceTree].
-===IDE integration===
+----
+
+=To push changes to our repository:=
+
+Once you've cloned our repository by following the above instructions,
authorized users can push changes.
+
+*Windows users who installed the Kiln client:*
+
+You can either use the graphical "Synchronize" command by right-clicking
on any file or folder in the repository or simply "`hg push`" from the
command line. The Kiln Client will take care of authentication.
+
+*Mac/Unix users or Windows users who aren't using the Kiln Client:*
+
+You can simply "`hg push`" from the command line, and you'll be asked for
authentication. To avoid being asked for authentication every time you
push, you can
[http://kiln.stackexchange.com/questions/341/how-can-i-install-kilns-mercurial-extensions-manually/342/
install the Kiln mercurial extensions by following these directions].
+
+----
+
+=Other helpful info:=
+
+*IDE integration:*
There are some handy Mercurial integration tools for <a
href="http://kiln.stackexchange.com/search?q=[integration]+visual%20studio">Visual
Studio</a> and <a
href="http://kiln.stackexchange.com/search?q=[integration]+eclipse">Eclipse</a>
users.
-===Mercurial for Subversion users (and more)===
+*Mercurial for Subversion users (and more):*
If you want to learn more about how to use Mercurial (especially if you're
familiar with Subversion), we highly recommend reading the
[http://hginit.com hginit Mercurial tutorial].