Merge pull request #409 from yukiisbored/information-overload

Remove information overload from toctrees

source/index.md

@@ -9,7 +9,6 @@ myst:
 
 # Welcome to nix.dev
 
-:::{topic} **Introduction**
 The Nix ecosystem is a DevOps toolkit to achieve:
 
 - {ref}`Reproducible development environments <ad-hoc-envs>`.
@@ -29,11 +28,10 @@ The Nix ecosystem is a DevOps toolkit to achieve:
 This documentation supplements the official [Nix](http://nixos.org/nix/manual/),
 [NixOS](http://nixos.org/nixos/manual/), [Nixpkgs](http://nixos.org/nixpkgs/manual/)
 and [NixOps](http://nixos.org/nixops/manual/) manuals.
-:::
 
 ```{toctree}
 :glob: true
-:maxdepth: 3
+:maxdepth: 1
 
 tutorials/index.md
 templates/index.md

source/reference/index.md

@@ -1,7 +1,10 @@
 # Reference
 
+This section contains articles which are supplementary to the [tutorials](../tutorials/index.md).
+
 ```{toctree}
 :glob: true
+:maxdepth: 1
 
 pinning-nixpkgs.md
 ```

source/tutorials/index.md

@@ -1,8 +1,10 @@
 # Tutorials
 
+This section contains a collection of articles on how to get things done in the Nix ecosystem.
+
 ```{toctree}
 :glob: true
-:maxdepth: 2
+:maxdepth: 1
 
 install-nix.md
 ad-hoc-developer-environments.md