docs/options: Add option reference generator

Evaluate custom module options through a synthetic system, stabilize configuration-dependent defaults for rendering, and commit the generated reference beside its updater.
2026-08-01 23:59:17 +01:00
parent 4084dfe64e
commit b44095f1ed
7 changed files with 472 additions and 9 deletions
@@ -190,6 +190,9 @@ let
    type = unspecified;
    default = ext;
    visible = "shallow";
+    # Build-target plumbing: the default evaluates a whole alternate system, so keep
+    # it out of the generated option docs (see `optionsDoc` in flake.nix).
+    internal = true;
    description = "Configuration as ${desc}.";
  };
 in