## 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
22 lines
482 B
Markdown
22 lines
482 B
Markdown
---
|
|
title: Explanation
|
|
tags:
|
|
- explanation
|
|
---
|
|
|
|
# Explanation
|
|
|
|
Understanding-oriented content explaining the "why" behind BlumeOps design decisions.
|
|
|
|
## Philosophy
|
|
|
|
| Article | Description |
|
|
|---------|-------------|
|
|
| [[why-gitops]] | Why infrastructure-as-code and GitOps for a homelab |
|
|
|
|
## Design
|
|
|
|
| Article | Description |
|
|
|---------|-------------|
|
|
| [[architecture]] | How all the pieces fit together |
|
|
| [[security-model]] | Network security, secrets, and access control |
|