summary refs log tree commit diff
path: root/doc/manual.xml
diff options
context:
space:
mode:
authorFrederik Rietdijk <fridh@fridh.nl>2019-10-20 12:17:58 +0200
committerFrederik Rietdijk <fridh@fridh.nl>2019-10-20 13:35:04 +0200
commit95dfbe2d632b71a72634d2d65e3f738f500ee5ce (patch)
treec3da9c73c48a65a204e47de113c82e9efdac037a /doc/manual.xml
parentaf7378397fafd63384c4c7a28ba22b0803b00a18 (diff)
downloadnixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.tar
nixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.tar.gz
nixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.tar.bz2
nixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.tar.lz
nixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.tar.xz
nixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.tar.zst
nixpkgs-95dfbe2d632b71a72634d2d65e3f738f500ee5ce.zip
doc: organize chapters into parts, and reduce toc depth
Reorganize the chapters into parts and reduce the TOC depth to make the
TOC useful again. The top-level TOC is very brief, but that is fine
because every part will have its own TOC.

Section titles of languages/frameworks are also simplified to just
the name of the language/framework.
Diffstat (limited to 'doc/manual.xml')
-rw-r--r--doc/manual.xml44
1 files changed, 28 insertions, 16 deletions
diff --git a/doc/manual.xml b/doc/manual.xml
index ab845e1a108..7015e18d1e9 100644
--- a/doc/manual.xml
+++ b/doc/manual.xml
@@ -6,20 +6,32 @@
   </subtitle>
  </info>
  <xi:include href="introduction.chapter.xml" />
- <xi:include href="quick-start.xml" />
- <xi:include href="package-specific-user-notes.xml" />
- <xi:include href="stdenv.xml" />
- <xi:include href="multiple-output.xml" />
- <xi:include href="cross-compilation.xml" />
- <xi:include href="configuration.xml" />
- <xi:include href="functions.xml" />
- <xi:include href="meta.xml" />
- <xi:include href="languages-frameworks/index.xml" />
- <xi:include href="platform-notes.xml" />
- <xi:include href="package-notes.xml" />
- <xi:include href="overlays.xml" />
- <xi:include href="coding-conventions.xml" />
- <xi:include href="submitting-changes.xml" />
- <xi:include href="reviewing-contributions.xml" />
- <xi:include href="contributing.xml" />
+ <part>
+  <title>Using Nixpkgs</title>
+  <xi:include href="configuration.xml" />
+  <xi:include href="overlays.xml" />
+  <xi:include href="functions.xml" />
+ </part>
+ <part>
+  <title>Standard environment</title>
+  <xi:include href="stdenv.xml" />
+  <xi:include href="meta.xml" />
+  <xi:include href="multiple-output.xml" />
+  <xi:include href="cross-compilation.xml" />
+  <xi:include href="platform-notes.xml" />
+ </part>
+ <part>
+  <title>Languages, frameworks and packages</title>
+  <xi:include href="languages-frameworks/index.xml" />
+  <xi:include href="package-specific-user-notes.xml" />
+  <xi:include href="package-notes.xml" />
+ </part>
+ <part>
+  <title>Contributing to Nixpkgs</title>
+  <xi:include href="quick-start.xml" />
+  <xi:include href="coding-conventions.xml" />
+  <xi:include href="submitting-changes.xml" />
+  <xi:include href="reviewing-contributions.xml" />
+  <xi:include href="contributing-to-documentation.xml" />
+ </part>
 </book>