Phase 2: Add Reference section with 24 technical reference cards #88

Merged

eblume merged 12 commits from feature/docs-phase-2-reference into main

2026-02-03 14:27:38 -08:00

Author	SHA1	Message	Date
Erich Blume	f2c7c29146	Add photos NFS export to sifaka card Verified against actual k8s PVs - all three NFS exports now listed: - /volume1/torrents (kiwix, transmission) - /volume1/music (navidrome) - /volume1/photos (immich) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 14:25:33 -08:00
Erich Blume	9ca698087c	Add Immich to k8s apps registry - Clarify immich deployment is k8s Helm chart - Add immich entry to kubernetes/apps.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 14:24:17 -08:00
Erich Blume	3c72f1d2ae	Add Backup section to sifaka card Clarifies that sifaka is the backup TARGET, not source. Notes RAID 5 for current protection, offsite planned for future. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 14:21:42 -08:00
Erich Blume	4838da600e	Add Immich service card - New services/immich.md card - Update sifaka to link photos share to Immich - Add Immich to services index Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 14:17:21 -08:00
Erich Blume	1665fa90e0	Link postgresql backup section to operations/backup Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 14:11:47 -08:00
Erich Blume	cfbf8e4803	Add note about Alloy CGO build possibly being obsolete With *.ops.eblu.me URLs routed via Caddy, Tailscale MagicDNS resolution may no longer be needed. Should be tested. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 14:03:00 -08:00
Erich Blume	10b062051d	Add operations reference cards - observability - links to prometheus, loki, alloy, grafana - backup - links to borgmatic, sifaka, backup policy - disaster-recovery - TBD, links to borgmatic, 1password, forgejo Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 13:58:41 -08:00
Erich Blume	6f8fb33122	Add kubernetes/external-secrets redirect card Links to services/1password for discoverability from kubernetes section. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 13:47:12 -08:00
Erich Blume	0eac3c0384	Add storage/postgresql redirect card Links to services/postgresql for discoverability from storage section. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 13:46:20 -08:00
Erich Blume	ad7e9af453	Trim operational content from reference cards Reference docs should describe "what things are", not "how to do things". Removed: - CLI command examples - Operational workflows (PR workflow, sync commands) - Setup/bootstrap procedures - "Useful Commands" sections Also split hosts.md into individual cards: - infrastructure/indri.md - Primary server details - infrastructure/gilbert.md - Development workstation This content belongs in how-to guides (future phase). Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 13:44:26 -08:00
Erich Blume	649ae15204	Fix escaped pipes in wiki-links Remove backslash escaping from pipe characters in wiki-links. Correct: [[services/forgejo\|Forgejo]] Wrong: [[services/forgejo\\|Forgejo]] Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 13:33:14 -08:00
Erich Blume	0018d3c593	Add Reference section with 24 technical reference cards Phase 2 of documentation restructuring. Creates docs/reference/ with: Services (16): - alloy, argocd, borgmatic, 1password, forgejo, grafana - jellyfin, kiwix, loki, miniflux, navidrome, postgresql - prometheus, teslamate, transmission, zot Infrastructure (3): - hosts - Device inventory - tailscale - ACLs, groups, tags - routing - DNS domains and port mappings Kubernetes (2): - cluster - Minikube specs - apps - ArgoCD application registry Storage (2): - sifaka - Synology NAS configuration - backups - Backup policy All cards use wiki-links for cross-referencing and include YAML frontmatter with title and tags for Quartz. Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>	2026-02-03 13:23:24 -08:00