add gitremotes script, parsing list of remotes on doc/git.mdwn
[ikiwiki.git] / doc / git.mdwn
index 8005dcf6ec5a4a03ae0a04cd740afa49b19d65ce..00c108616a60ab7d3f52afb3c9ca07f172e562e3 100644 (file)
@@ -1,5 +1,12 @@
-Ikiwiki is developed in a git repository and can be checked out 
-like this:
+Ikiwiki, and this documentation wiki, are developed in a git repository and
+can be checked out like this:
+
+[[!template id=note text="""
+You can push changes back to ikiwiki's git repository over the `git://`
+transport, to update this wiki, if you'd like, instead of editing it on the
+web. Changes that could not be made via the web will be automatically
+rejected.
+"""]]
 
        git clone git://git.ikiwiki.info/
 
@@ -11,12 +18,27 @@ The gitweb is [here](http://git.ikiwiki.info/?p=ikiwiki).
 
 Commits to this git repository are fed into [CIA](http://cia.vc), and can
 be browsed, subscribed to etc on its
-[project page](http://cia.vc/stats/project/ikiwiki).
+[project page](http://cia.vc/stats/project/ikiwiki). They're also fed into
+[twitter](http://twitter.com/ikiwiki).
 
-## branches
+## personal git repositories
 
 You are of course free to set up your own ikiwiki git repository with your
-own [[patches|patch]].
+own [[patches|patch]]. If you list it here, the `gitremotes` script will
+automatically add it to git remotes. Your repo will automatically be pulled
+into [[Joey]]'s working tree. This is recommended. :-)
+
+# Machine-parsed format: * wikilink <git:url> 
+
+* [[github]] <git://github.com/joeyh/ikiwiki.git> 
+  [browse](http://github.com/joeyh/ikiwiki/tree/master)
+  A mirror of the main repo, automatically updated.
+* [[smcv]] <git://git.pseudorandom.co.uk/git/smcv/ikiwiki.git>
+* [[intrigeri]] <git://gaffer.ptitcanardnoir.org/ikiwiki.git>
+* [[gmcmanus]] <git://github.com/gmcmanus/ikiwiki.git>
+* [[jelmer]] <git://git.samba.org/jelmer/ikiwiki.git>
+
+## branches
 
 Some of the branches included in the main repository include:
 
@@ -27,6 +49,10 @@ Some of the branches included in the main repository include:
   instead of xhtml.
 * `wikiwyg` adds [[todo/wikiwyg]] support. It is unmerged pending some
   changes.
+* `darcs` is being used to add darcs support.
+* `debian-stable` is used for updates to the old version included in
+  Debian's stable release, and `debian-testing` is used for updates to
+  Debian's testing release.
 * `pristine-tar` contains deltas that
   [pristine-tar](http://kitenet.net/~joey/code/pristine-tar)
   can use to recreate released tarballs of ikiwiki