diff --git a/doc/manual/hacking.xml b/doc/manual/hacking.xml
new file mode 100644
index 00000000..5a5ff9ca
--- /dev/null
+++ b/doc/manual/hacking.xml
@@ -0,0 +1,39 @@
+<appendix xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xml:id="chap-hacking">
+
+<title>Hacking</title>
+
+<para>This section provides some notes on how to hack on Hydra.  To
+get the latest version of Hydra from GitHub:
+<screen>
+$ git clone git://github.com/NixOS/hydra.git
+$ cd hydra
+</screen>
+</para>
+
+<para>To build it and its dependencies:
+<screen>
+$ nix-build release.nix -A build.x86_64-linux
+</screen>
+</para>
+
+<para>To build all dependencies and start a shell in which all
+environment variables (such as <envar>PERL5LIB</envar>) are set up so
+that those dependencies can be found:
+<screen>
+$ ./dev-shell
+</screen>
+To build Hydra, you should then do:
+<screen>
+[nix-shell]$ ./bootstrap
+[nix-shell]$ configurePhase
+[nix-shell]$ make
+</screen>
+You can run the Hydra web server in your source tree as follows:
+<screen>
+$ ./src/script/hydra-server
+</screen>
+</para>
+
+</appendix>