Erich Blume
dc46eb7def
## Summary - Updated frontmatter `title:` in all 63 doc cards from slug-case to human-readable (e.g. `borgmatic` → `Borgmatic`, `ai-assistance-guide` → `AI Assistance Guide`) - Titles now closely match file stems so `[[wiki-links]]` render naturally without alternate anchor text - Corrected titles that diverged from stems (e.g. `host-inventory` → `Hosts`, `grafana-alloy` → `Alloy`, `argocd-applications` → `Apps`) - Deleted `title-test-alpha.md` and `title-test-beta.md` test cards and removed their reference index entry ## Deployment and Testing - [x] `docs-check-links` passes — all wiki-links valid - [x] `docs-check-index` passes - [x] `docs-check-filenames` passes - [ ] Verify titles render correctly on docs site after deploy Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/117
48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
---
|
|
title: Tutorials
|
|
tags:
|
|
- tutorials
|
|
---
|
|
|
|
# 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 |
|
|
| [[tailscale-setup|Tailscale Setup]] | Replicator | Setting up Tailscale networking |
|
|
| [[core-services|Core Services]] | Replicator | Forgejo and container registry |
|
|
| [[kubernetes-bootstrap|Kubernetes Bootstrap]] | Replicator | Bootstrapping a Kubernetes cluster |
|
|
| [[argocd-config|ArgoCD Config]] | Replicator | Configuring GitOps with ArgoCD |
|
|
| [[observability-stack|Observability Stack]] | Replicator | Metrics, logs, and dashboards |
|