diff --git a/doc/coding-conventions.xml b/doc/coding-conventions.xml
index b941e3ca2a6d..282fad66280c 100644
--- a/doc/coding-conventions.xml
+++ b/doc/coding-conventions.xml
@@ -207,7 +207,7 @@ args.stdenv.mkDerivation (args // {
 </section>
 
 
-<section><title>File naming and organisation</title>
+<section xml:id="sec-organisation"><title>File naming and organisation</title>
 
 <para>Names of files and directories should be in lowercase, with
 dashes between words — not in camel case.  For instance, it should be
diff --git a/doc/quick-start.xml b/doc/quick-start.xml
index 6f49bee4b64e..9cacb1fcccf1 100644
--- a/doc/quick-start.xml
+++ b/doc/quick-start.xml
@@ -25,8 +25,8 @@ $ cd nixpkgs</screen>
     <filename>pkgs/development/libraries/<replaceable>pkgname</replaceable></filename>,
     while a web browser goes into
     <filename>pkgs/applications/networking/browsers/<replaceable>pkgname</replaceable></filename>.
-    See Section XXX for some hints on the tree organisation.  Create a
-    directory for your package, e.g.
+    See <xref linkend="sec-organisation" /> for some hints on the tree
+    organisation.  Create a directory for your package, e.g.
 
 <screen>
 $ svn mkdir pkgs/development/libraries/libfoo</screen>