docs: sort the top-level directories into five sections by what the reader wants
Every docs directory moves under 1-getting-started, 2-handbook, 4-implementation or 5-project; the options reference (section 3) comes from the website and has no directory here. trust-boundary stays whole under the handbook for now. web-ui, swarm and tools split between handbook and implementation, and the command-line references move to 2-handbook/reference. Links, path references in code and nix, and the docs index follow the moves; no page content changes.
This commit is contained in:
parent
53ccbcb4b3
commit
6739bb903d
1 changed files with 736 additions and 701 deletions
|
|
@ -5,7 +5,7 @@
|
|||
# answers on the hive bridge, so neither can be confined to a network
|
||||
# namespace of its own.
|
||||
# Full vhost map + discovery flow + design rationale in
|
||||
# `docs/networking/gateway.md`. Layout: ./options.nix (option declarations),
|
||||
# `docs/4-implementation/networking/gateway.md`. Layout: ./options.nix (option declarations),
|
||||
# ./vhosts.nix (the catch-all `_` vhost), ./declared-vhosts.nix
|
||||
# (renders the vhosts service modules declare under `gateway.vhosts`), ./error-pages.nix
|
||||
# (styled static pages), ./dns.nix + ./dnsmasq.nix (the resolver, which
|
||||
|
|
@ -241,7 +241,7 @@ in
|
|||
# and it puts a file at every cert path the config names or fails: one
|
||||
# nginx cannot find takes the WHOLE gateway down, not one vhost. Both
|
||||
# mechanisms, and what it cost the time this was
|
||||
# collapsed: `docs/networking/gateway.md::Self-signed TLS (default)`.
|
||||
# collapsed: `docs/4-implementation/networking/gateway.md::Self-signed TLS (default)`.
|
||||
#
|
||||
# ALWAYS runs (no ConditionPathExists) and is idempotent, because it
|
||||
# has to reconcile broken state from earlier failed boots — a 0700 dir
|
||||
|
|
@ -350,7 +350,7 @@ in
|
|||
# through hive-priv after each agents.conf write, deliberately as an
|
||||
# explicit trigger rather than a path unit. Why, and what hive-priv
|
||||
# dispatches per unit state:
|
||||
# `docs/networking/gateway.md::Per-agent unix-socket upstream`.
|
||||
# `docs/4-implementation/networking/gateway.md::Per-agent unix-socket upstream`.
|
||||
|
||||
services.nginx = {
|
||||
enable = true;
|
||||
|
|
@ -414,7 +414,7 @@ in
|
|||
};
|
||||
|
||||
# `/etc/hosts` entries for local dev — the bare hive domain plus
|
||||
# every name a service module contributed. See `docs/networking/gateway.md`
|
||||
# every name a service module contributed. See `docs/4-implementation/networking/gateway.md`
|
||||
# ("Local dev").
|
||||
#
|
||||
# This does not restate the per-service list (the vhosts and the
|
||||
|
|
|
|||
Loading…
Reference in a new issue