_Sidebar
Dmitrii Iurco edited this page 2026-06-11 15:47:54 -04:00
Clone

Wiki Page Revisions

4 Commits

Author SHA1 Message Date
roof b54d42ba57 fix: scope ADRs to product/code decisions only
ADR – 001 refocused from the CI pipeline onto the product decision (cells
verify digest-pinned, cosign-signed store images; enforce by default).
ADR – 004 (docs process) archived — out of ADR scope per maintainer rule.
Sidebar gains an Archive section so archived pages stay discoverable.
2026-06-11 15:47:54 -04:00
roof 469406a806 docs(phase-a): rename all pages to graded titles, rewrite Home and Sidebar, add headers
Renames (22 pages → 21 pages; PIC.md deleted as empty):
- Noobs-Start-Here.md → User – Start Here.md (full rewrite)
- User-Guide.md → Archive – User Guide.md (nav stub archived; content folded into Start Here)
- User-Connect-VPN.md → User – Connect to the VPN.md
- User-Services.md → User – Use Your Services.md
- Admin-Guide.md → Admin – Overview.md
- Admin-Setup.md → Admin – Install and First Run.md
- Admin-Domains-TLS.md → Admin – Configure Domains and TLS.md
- Admin-Services.md → Admin – Manage Services.md
- Admin-Connectivity.md → Admin – Configure Connectivity.md
- Admin-Peers.md → Admin – Manage Peers.md
- Admin-Backup.md → Admin – Back Up and Restore.md
- Admin-Logging-Audit.md → Admin – Logging and Audit.md
- Admin-Monitoring-Troubleshooting.md → Admin – Monitor and Troubleshoot.md
- Dev-Guide.md → Dev – Overview.md
- Dev-Architecture.md → Dev – Architecture.md
- Dev-API.md → Dev – API Reference.md
- Dev-Building-Services.md → Dev – Build a Store Service.md
- Dev-Service-Manifest-Reference.md → Dev – Service Manifest Reference.md
- Dev-Testing.md → Dev – Testing.md
- Dev-Install-Internals.md → Dev – Install Internals.md

All pages: added mandatory header block (Status/Owner/Updated; Applies-to on
version-dependent pages). All inbound links updated to [[Page Name]] wiki-style.

Home.md: rewritten as navigation hub only — no substantive content, three clear
audience doors, links to FAQ/Troubleshooting/Glossary (Phase B pages).

_Sidebar.md: reorganised into Home / New here? / Users / Admins / Developers /
Decisions (ADRs) / Meta sections with ADR and Meta slots for Phase B and C pages.

Boy-scout fixes applied: removed "simply/just" language, added code block context
comments (Run on:), added Warning blocks on destructive commands, removed stale
DHCP references (DHCP was removed; cell-dns is CoreDNS only), corrected test count
to ~3218 (verified in source), corrected image_verification default to 'enforce'
(verified in config_manager.py).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 15:30:41 -04:00
roof eb887c7a2c docs: image verification (enforce default) + full service manifest reference
The repo's markdown manuals are being consolidated into this wiki so the
repo keeps only README.md. Adds the complete manifest/compose/accounts/
backup/egress reference (ported from docs/service-developer-guide.md,
corrected: HTTP account dispatch is implemented, egress uses Connectivity
v2 named instances, images are digest-pinned + signed). Documents the
image_verification setting now that enforce is the default. Cleans stale
CI-runner and test-count notes in Dev-Testing.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 14:13:13 -04:00
roof fe38244536 Add full four-audience wiki: noobs, user, admin, dev
21 pages covering all audiences verified against source code:
- Home.md + _Sidebar.md (landing + nav)
- Noobs-Start-Here.md (plain-language intro, one-line install)
- User-Guide.md, User-Connect-VPN.md, User-Services.md (peer audience)
- Admin-Guide.md + 8 subpages: setup, domains/TLS, services, connectivity
  (named connections, fail-open/closed, cell-relay), peers, backup,
  logging/audit, monitoring/troubleshooting
- Dev-Guide.md + 5 subpages: architecture (connectivity v2 data model,
  cell-to-cell), building services (manifest v3), API reference,
  testing, install internals

All content verified against api/, install.sh, Makefile, docs/, and
pic-services/.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-10 23:53:12 -04:00