Erich Blume 0a28622751 Add Phase 5: explanation documentation (#96 )

## Summary
- Create `docs/explanation/` directory with index and three explanation articles
- why-gitops: Philosophy of GitOps for homelabs (memory, rollback, AI context)
- architecture: How pieces fit together (ASCII diagrams of hosts, data flow, secrets)
- security-model: Tailscale zero-trust, 1Password secrets, access control philosophy
- Update docs/index.md with How-to and Explanation section links
- Update exploring-the-docs to link Explanation section

Decision log deferred to future work.

## Deployment and Testing
- [x] Pre-commit hooks pass (including doc-links validator)
- [ ] Build and deploy to docs.ops.eblu.me to verify rendering

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/96

2026-02-03 20:33:39 -08:00

482 B

Raw Blame History

title

Explanation

Understanding-oriented content explaining the "why" behind BlumeOps design decisions.

Philosophy

Article	Description
why-gitops	Why infrastructure-as-code and GitOps for a homelab

Design

Article	Description
architecture	How all the pieces fit together
security-model	Network security, secrets, and access control

482 B Raw Blame History

Explanation

Philosophy

Design

482 B

Raw Blame History