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>
## Summary
- Create `docs/how-to/` directory with index and four how-to guides
- deploy-k8s-service: Quick reference for Kubernetes deployments via ArgoCD
- add-ansible-role: Adding new Ansible roles for indri services
- update-tailscale-acls: Modifying Tailscale ACL policies via Pulumi
- troubleshooting: Diagnosing and fixing common issues
- Update exploring-the-docs to include How-to section links
- Update README.md to mark Phase 4 as complete
## 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/95