docs: split swarm/deploy options into their own reference pages
services.hyperhive.swarm.* used to carry both swarm-wide facts (name, domain, hives, ca) and the 'does THIS host run it' toggles for every swarm service. deploy.nix already split those toggles out into their own services.hyperhive.deploy.* namespace; this is the docs-side follow-up now that swarm.* is genuinely swarm-wide-only. nix/docs/default.nix: host.md drops the swarm/deploy subtrees (builtins.removeAttrs on the already-picked host tree, not lib.recursiveUpdate -- that merges rather than deletes, which would have silently kept them on host.md); swarm.md and deploy.md are new markdown pages, each its own pickSubtrees root. nix/packages/default.nix exposes docs-swarm/docs-deploy as flake outputs alongside the existing docs-host/docs-agent. docs/gotchas.md's Nix options reference section and docs/swarm/README.md get pointers to the new split.
This commit is contained in:
parent
09fe94a8ca
commit
a05d686875
4 changed files with 103 additions and 19 deletions
|
|
@ -259,11 +259,13 @@ in
|
|||
ruth-toplevel = self.nixosConfigurations.ruth.config.system.build.toplevel;
|
||||
|
||||
# Auto-generated nix options reference for hyperhive.
|
||||
# `docs` bundles host + agent pages into one tree; the split
|
||||
# outputs are useful when consumers only want one surface.
|
||||
# All three are pure markdown — no rust or frontend deps in
|
||||
# `docs` bundles host + swarm + deploy + agent pages into one tree;
|
||||
# the split outputs are useful when consumers only want one surface.
|
||||
# All five are pure markdown — no rust or frontend deps in
|
||||
# the closure, so `nix build .#docs` is cheap.
|
||||
docs = docsAttrs.bundle;
|
||||
docs-host = docsAttrs.host;
|
||||
docs-swarm = docsAttrs.swarm;
|
||||
docs-deploy = docsAttrs.deploy;
|
||||
docs-agent = docsAttrs.agent;
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue