From 35ff30c73fa312990d88a74aa5951094ecd1b461 Mon Sep 17 00:00:00 2001
From: Eelco Dolstra <eelco.dolstra@logicblox.com>
Date: Wed, 3 Jun 2015 17:03:07 +0200
Subject: [PATCH] Streamline contributing section

---
 doc/contributing.xml | 19 ++++++++++---------
 1 file changed, 10 insertions(+), 9 deletions(-)

diff --git a/doc/contributing.xml b/doc/contributing.xml
index f622845bf1a..ee93be4447a 100644
--- a/doc/contributing.xml
+++ b/doc/contributing.xml
@@ -4,16 +4,17 @@
 
 <title>Contributing</title>
 
-<para>If you make modifications to the manual, it's important to build the manual before contributing:</para>
+<para>The DocBook sources of the Nixpkgs manual are in the <filename
+xlink:href="https://github.com/NixOS/nixpkgs/tree/master/doc">doc</filename>
+subdirectory of the Nixpkgs repository. If you make modifications to
+the manual, it's important to build it before committing. You can do that as follows:
 
-<orderedlist>
+<screen>
+$ cd /path/to/nixpkgs
+$ nix-build doc
+</screen>
 
-  <listitem><para><command>$ git clone git://github.com/NixOS/nixpkgs.git</command></para></listitem>
-
-  <listitem><para><command>$ nix-build -A manual nixpkgs/pkgs/top-level/release.nix</command></para></listitem>
-  
-  <listitem><para>Inside the built derivation you shall see <literal>manual/index.html</literal> file.</para></listitem>
-
-</orderedlist>
+If the build succeeds, the manual will be in
+<filename>./result/share/doc/nixpkgs/manual.html</filename>.</para>
 
 </chapter>