eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

Add Phase 5: explanation documentation #96

Merged
eblume merged 2 commits from docs/phase5-explanation into main 2026-02-03 20:33:40 -08:00
Conversation 0 Commits 2 Files changed 8 +396 -10
eblume commented 2026-02-03 20:24:04 -08:00
Owner
Copy link

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

  • Pre-commit hooks pass (including doc-links validator)
  • Build and deploy to docs.ops.eblu.me to verify rendering

🤖 Generated with Claude Code

## 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)
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>
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
eblume merged commit 0a28622751 into main 2026-02-03 20:33:40 -08:00
Sign in to join this conversation.
Reviewers
No reviewers
Labels
Clear labels
No items
No labels
Milestone
Clear milestone
No items
No milestone
Projects
Clear projects
No items
No project
Assignees
Clear assignees
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
eblume/blumeops!96
No description provided.