Erich Blume 1e4e72b923 Address PR review feedback for Phase 3 tutorials

Tutorial changes:
- Replace what-is-blumeops with adding-a-service tutorial
- Update ai-assistance-guide with Mise Tasks table
- Update contributing with tooling setup, target revisions, DNS preview
- Remove AI-only sections from contributing and exploring-the-docs
- Add replicator explanation to exploring-the-docs
- Add pre-commit link validation note
- Add Core Services phase to replication roadmap
- Add docs service to services list in replicating-blumeops

New reference cards:
- docs.md - Quartz documentation service
- tailscale-operator.md - Kubernetes ingress operator
- ansible/roles.md - Available ansible roles

Other updates:
- Add mise to Brewfile
- Update docs/index.md to link to exploring-the-docs
- Add notes to update exploring-the-docs in future phases
- Link tailscale-operator from apps.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

2026-02-03 18:50:51 -08:00

1.9 KiB

Raw Blame History

title

Tutorials

Learning-oriented guides for understanding and working with BlumeOps.

Audience Guide

Each tutorial indicates which audiences it serves:

Icon	Audience	Description
Owner	Erich	Quick recall and operational refreshers
AI	Claude/AI agents	Context for AI-assisted operations
Reader	External readers	Understanding what BlumeOps is
Contributor	Operators/contributors	Helping with BlumeOps development
Replicator	Replicators	Building your own similar setup

Getting Started

Tutorial	Audiences	Description
exploring-the-docs	All	How to navigate and use this documentation
ai-assistance-guide	AI, Owner	Context for effective AI-assisted operations

Contributing

Tutorial	Audiences	Description
contributing	Contributor	Your first contribution to BlumeOps
adding-a-service	Contributor, Replicator	Deploy a new service via ArgoCD

Replication

For those building their own homelab GitOps setup.

Tutorial	Audiences	Description
replicating-blumeops	Replicator	Overview: building a similar environment
[[tutorials/replication/tailscale-setup	Tailscale Setup]]	Replicator
[[tutorials/replication/core-services	Core Services]]	Replicator
[[tutorials/replication/kubernetes-bootstrap	Kubernetes Bootstrap]]	Replicator
[[tutorials/replication/argocd-config	ArgoCD Config]]	Replicator
[[tutorials/replication/observability-stack	Observability Stack]]	Replicator

1.9 KiB Raw Blame History