Erich Blume
0a28622751
## 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
22 lines
482 B
Markdown
22 lines
482 B
Markdown
---
|
|
title: explanation
|
|
tags:
|
|
- explanation
|
|
---
|
|
|
|
# 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 |
|