Add Phase 5: explanation documentation

Understanding-oriented content explaining the "why" behind BlumeOps:
- why-gitops: Philosophy of infrastructure-as-code for homelabs
- architecture: How all the pieces fit together (hosts, services, data flow)
- security-model: Tailscale networking, 1Password secrets, access control

Also updates docs/index.md with How-to and Explanation sections.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Erich Blume 2026-02-03 20:23:45 -08:00
commit 7be34dca60
8 changed files with 390 additions and 10 deletions

View file

@ -20,7 +20,7 @@ The docs follow the [Diataxis](https://diataxis.fr/) framework:
| **[[tutorials/index | Tutorials]]** | Learning-oriented | "I'm new and want to understand" |
| **[[reference/index | Reference]]** | Information-oriented | "I need specific technical details" |
| **[[how-to/index | How-to]]** | Task-oriented | "I need to do X" |
| **Explanation** (planned) | Understanding-oriented | "I want to understand why" |
| **[[explanation/index | Explanation]]** | Understanding-oriented | "I want to understand why" |
## Quick Paths by Audience
@ -42,9 +42,9 @@ Context for effective assistance:
### For External Readers
Understanding what this is:
- [[explanation/index|Explanation]] covers the "why" behind design decisions
- [[reference/index|Reference]] shows what's actually running
- Browse service pages to see specific implementations
- The repo's README has project context
### For Contributors
@ -58,6 +58,7 @@ Getting started with changes:
Replicators are people who want to build their own similar homelab GitOps setup, using BlumeOps as inspiration.
- [[replicating-blumeops]] provides the overview
- [[explanation/index|Explanation]] covers architecture and design rationale
- The `replication/` tutorials go deep on components
- Reference pages show specific configuration choices