Add new page ``How to Contribute to This Wiki'' and link to it.

2 files changed, 77 insertions, 1 deletions

diff --git a/HowToContributeToThisWiki.mdwn b/HowToContributeToThisWiki.mdwn
new file mode 100644
index 00000000..a764031e
--- /dev/null
+++ b/HowToContributeToThisWiki.mdwn
@@ -0,0 +1,75 @@
+# How to Contribute to This Wiki
+
+There are essentially three possibilities.  They are outlined below.
+
+
+Some general hints; just as in software projects:
+
+* Do independent changes *separately*: don't aggregate changes that don't
+  belong together.
+* Install your changes *early* and *often*: don't hold your contribution back
+  until you think it is perfect.
+
+
+If you are editing the source files from a git checkout you can nevertheless
+have them get rendered to html pages:
+
+	$ wiki/render_locally
+	[...]
+	scanning HowToContributeToThisWiki.mdwn
+	rendering HowToContributeToThisWiki.mdwn
+	
+	Now open `wiki.rendered/index.html' to browse the wiki pages.
+
+
+## Edit Via the Web Interface
+
+When you found a page you want to work on, just follow the *Edit* link on the
+top of the page.  When doing this for the first time, this will first transfer
+you to a page where you have to create a wiki account.  After logging in, you
+can edit the wiki pages.
+
+
+## Do an Anonymous Checkout of the git Repository
+
+*Not yet available.*
+
+Check out the wiki.
+
+	$ git clone git://flubber.bddebian.com/wiki [dest]
+
+If you omit *[dest]* it will default to *wiki*.
+
+Then you can work on these files.
+
+	$ cd wiki/
+	$ emacs Hurd/NextHurd.mdwn
+	$ git commit Hurd/NextHurd.mdwn
+
+Finally publish your changes.
+
+	$ [TODO]
+
+
+## Do a Read-write Checkout of the git Repository
+
+For being able to do that you need a
+[[shell_account_on_*flubber*|Hurd/PublicHurdBoxen]].  (It's very much
+recommenable that you set up your local *ssh* configuration as advised on that
+page.)
+
+Check out the wiki.
+
+	$ git clone flubber:~wiki/wiki [dest]
+
+If you omit *[dest]* it will default to *wiki*.
+
+Then you can work on these files.
+
+	$ cd wiki/
+	$ emacs Hurd/NextHurd.mdwn
+	$ git commit Hurd/NextHurd.mdwn
+
+Finally install your changes.
+
+	$ git push
diff --git a/index.mdwn b/index.mdwn
index 15b1875a..2a25adc1 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -5,7 +5,8 @@ There a huge bunch of unpolished stuff on here, please help to tidy things up.
 Also these are not yet the latest revisions of the old wiki's pages, but
 those from Friday 2007-04-13.  I'll work on integrating the missing bits.
 
-I'll post instructions about how to effectively work with this wiki.
+See [[HowToContributeToThisWiki]] for advice about -- well, you guessed it
+already.
 
 ----