document installation methods (only vmroot yet)

ci.nix

@@ -47,6 +47,7 @@ let
           src = ./.;
           buildPhase = ''
             cat ${json} | fennel --correlate doc/parse-options.fnl > doc/modules-generated.rst
+            cat ${json} | fennel --correlate doc/parse-options-outputs.fnl system.outputs.vmroot  > doc/installers-generated.rst
             cp ${(import ./doc/hardware.nix)} doc/hardware.rst
             make -C doc html
           '';

doc/index.rst

@@ -12,6 +12,7 @@ Liminix
    development
    modules
    hardware
+   installers
 
 
 Indices and tables

doc/installers.rst

@@ -0,0 +1,8 @@
+Installers
+##########
+
+There are a number of different routes to getting
+Liminix onto devices, and which one you should use
+(or are able to use) varies according to the device.
+
+.. include:: installers-generated.rst

doc/parse-options-outputs.fnl

@@ -0,0 +1,11 @@
+(local yaml (require :lyaml))
+
+;; (local { : view } (require :fennel))
+
+(local outputs (collect [k v (ipairs arg)]
+                 (values v true)))
+
+(each [_ option (ipairs (yaml.load (io.read "*a")))]
+  (when (. outputs option.name)
+    (print (.. ".. _" option.name) "\n")
+    (print option.description)))