support links from device pages to their installation methods

2023-11-09 23:02:35 +00:00
parent a9760d239c
commit 5e046490de
4 changed files with 17 additions and 6 deletions
--- a/doc/hardware.nix
+++ b/doc/hardware.nix
@@ -5,8 +5,18 @@ let
    builtins.readDir ../devices;
  texts = lib.mapAttrsToList (n: t:
    let d = import  ../devices/${n}/default.nix;
-        d' = { description = "no description for ${n}"; } // d;
-    in d'.description )
+        d' = {
+          description = "no description for ${n}";
+        } // d;
+        installer =
+          if d ? installer
+          then ''
+
+            The default installation route for this device is
+            :ref:`system-outputs-${d.installer}`
+          ''
+          else "";
+    in (d'.description + installer))
    devices;
 in
 writeText "hwdoc" ''