docs: centralize documentation under docs/

Move standalone repository docs from the root into docs/ and add a documentation index that links the moved docs and the code-local runbooks.

Update Markdown links, source comments, and the root entry points to the new locations. Keep README.md and AGENTS.md at the root as required entry points.

Assisted-by: DeepSeek Harness (deepseek-flash)
This commit is contained in:
Ryan Yin committed 2026-11-02 17:48:57 +08:00
1 parent be3e27c49b
commit 4470b3d014
30 files changed
+176 -88

No files matched your search

+7 -6
View File
@@ -30,9 +30,10 @@ This repository is home to the Nix code that builds all of my systems:
3. **NixOS servers** — three physical mini PCs running the VMs (libvirt and microVMs), the K3s test
cluster and the self-hosted services.
See [./hosts](./hosts) for the host inventory, [./outputs](./outputs) for how the flake outputs are
composed, [./docs](./docs) for the BIOS and Wake-on-LAN runbooks, [./BACKUP.md](./BACKUP.md) for the
backup design, and [./AGENTS.md](./AGENTS.md) for the repository conventions.
See [./docs](./docs/README.md) for the documentation index, [./hosts](./hosts) for the host
inventory, [./outputs](./outputs) for how the flake outputs are composed,
[BACKUP.md](./docs/BACKUP.md) for the backup design, and [./AGENTS.md](./AGENTS.md) for the
repository conventions.
## Why NixOS & Flakes?
@@ -98,9 +99,9 @@ See [./secrets](./secrets) for details.
## Security & Hardening
See [./SECURITY.md](./SECURITY.md) for the threat model, security architecture, controls and audit
status, [./hardening/README.md](./hardening/README.md) for application sandboxing and Linux
hardening, and [./WORKAROUNDS.md](./WORKAROUNDS.md) for temporary exceptions and known gaps.
See [SECURITY.md](./docs/SECURITY.md) for the threat model, security architecture, controls and
audit status, [./hardening/README.md](./hardening/README.md) for application sandboxing and Linux
hardening, and [WORKAROUNDS.md](./docs/WORKAROUNDS.md) for temporary exceptions and known gaps.
## How to Deploy this Flake?