Home
Dmitrii Iurco edited this page 2026-06-11 15:30:41 -04:00
Clone

Wiki Page Revisions

2 Commits

Author SHA1 Message Date
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 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