Erich Blume dc46eb7def Update all docs titles to human-readable (#117 )

## 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

2026-02-07 21:44:57 -08:00

1.8 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
[[tailscale-setup	Tailscale Setup]]	Replicator
[[core-services	Core Services]]	Replicator
[[kubernetes-bootstrap	Kubernetes Bootstrap]]	Replicator
[[argocd-config	ArgoCD Config]]	Replicator
[[observability-stack	Observability Stack]]	Replicator

1.8 KiB Raw Blame History