Update all docs titles to human-readable and delete test cards

Titles now use proper casing (e.g. "Borgmatic" instead of "borgmatic", "AI Assistance Guide" instead of "ai-assistance-guide") and match file stems so wiki-links work without alternate anchor text. Also removes the title-test-alpha/beta cards and their reference index entry. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-07 21:44:58 -08:00 · 2026-02-07 21:40:22 -08:00 · 2026-02-07 21:40:22 -08:00
commit c130f72204
67 changed files with 65 additions and 92 deletions
--- a/docs/changelog.d/docs-update-titles.doc.md
+++ b/docs/changelog.d/docs-update-titles.doc.md
@ -0,0 +1 @@
+Update all docs frontmatter titles from slug-case to human-readable and delete title-test cards.
--- a/docs/explanation/architecture.md
+++ b/docs/explanation/architecture.md
@ -1,5 +1,5 @@
 ---
-title: architecture
+title: Architecture
 tags:
  - explanation
  - architecture
--- a/docs/explanation/explanation.md
+++ b/docs/explanation/explanation.md
@ -1,5 +1,5 @@
 ---
-title: explanation
+title: Explanation
 tags:
  - explanation
 ---
--- a/docs/explanation/security-model.md
+++ b/docs/explanation/security-model.md
@ -1,5 +1,5 @@
 ---
-title: security-model
+title: Security Model
 tags:
  - explanation
  - security
--- a/docs/explanation/why-gitops.md
+++ b/docs/explanation/why-gitops.md
@ -1,5 +1,5 @@
 ---
-title: why-gitops
+title: Why GitOps
 tags:
  - explanation
  - philosophy
--- a/docs/how-to/add-ansible-role.md
+++ b/docs/how-to/add-ansible-role.md
@ -1,5 +1,5 @@
 ---
-title: add-ansible-role
+title: Add Ansible Role
 tags:
  - how-to
  - ansible
--- a/docs/how-to/deploy-k8s-service.md
+++ b/docs/how-to/deploy-k8s-service.md
@ -1,5 +1,5 @@
 ---
-title: deploy-k8s-service
+title: Deploy K8s Service
 tags:
  - how-to
  - kubernetes
--- a/docs/how-to/gandi-operations.md
+++ b/docs/how-to/gandi-operations.md
@ -1,5 +1,5 @@
 ---
-title: gandi-operations
+title: Gandi Operations
 tags:
  - how-to
  - dns
--- a/docs/how-to/how-to.md
+++ b/docs/how-to/how-to.md
@ -1,5 +1,5 @@
 ---
-title: how-to
+title: How-To
 tags:
  - how-to
 ---
--- a/docs/how-to/knowledgebase/review-documentation.md
+++ b/docs/how-to/knowledgebase/review-documentation.md
@ -1,5 +1,5 @@
 ---
-title: review-documentation
+title: Review Documentation
 tags:
  - how-to
  - documentation
--- a/docs/how-to/restart-indri.md
+++ b/docs/how-to/restart-indri.md
@ -1,5 +1,5 @@
 ---
-title: restart-indri
+title: Restart Indri
 tags:
  - how-to
  - operations
--- a/docs/how-to/troubleshooting.md
+++ b/docs/how-to/troubleshooting.md
@ -1,5 +1,5 @@
 ---
-title: troubleshooting
+title: Troubleshooting
 tags:
  - how-to
  - operations
--- a/docs/how-to/update-documentation.md
+++ b/docs/how-to/update-documentation.md
@ -1,5 +1,5 @@
 ---
-title: update-documentation
+title: Update Documentation
 tags:
  - how-to
  - documentation
--- a/docs/how-to/update-tailscale-acls.md
+++ b/docs/how-to/update-tailscale-acls.md
@ -1,5 +1,5 @@
 ---
-title: update-tailscale-acls
+title: Update Tailscale ACLs
 tags:
  - how-to
  - tailscale
--- a/docs/how-to/use-pypi-proxy.md
+++ b/docs/how-to/use-pypi-proxy.md
@ -1,5 +1,5 @@
 ---
-title: use-pypi-proxy
+title: Use PyPI Proxy
 tags:
  - how-to
  - python
--- a/docs/reference/ansible/roles.md
+++ b/docs/reference/ansible/roles.md
@ -1,5 +1,5 @@
 ---
-title: ansible-roles
+title: Roles
 tags:
  - ansible
  - reference
--- a/docs/reference/infrastructure/gandi.md
+++ b/docs/reference/infrastructure/gandi.md
@ -1,5 +1,5 @@
 ---
-title: gandi
+title: Gandi
 tags:
  - infrastructure
  - networking
--- a/docs/reference/infrastructure/gilbert.md
+++ b/docs/reference/infrastructure/gilbert.md
@ -1,5 +1,5 @@
 ---
-title: gilbert
+title: Gilbert
 tags:
  - infrastructure
  - host
--- a/docs/reference/infrastructure/hosts.md
+++ b/docs/reference/infrastructure/hosts.md
@ -1,5 +1,5 @@
 ---
-title: host-inventory
+title: Hosts
 tags:
  - infrastructure
 ---
--- a/docs/reference/infrastructure/indri.md
+++ b/docs/reference/infrastructure/indri.md
@ -1,5 +1,5 @@
 ---
-title: indri
+title: Indri
 tags:
  - infrastructure
  - host
--- a/docs/reference/infrastructure/routing.md
+++ b/docs/reference/infrastructure/routing.md
@ -1,5 +1,5 @@
 ---
-title: service-routing
+title: Routing
 tags:
  - infrastructure
  - networking
--- a/docs/reference/infrastructure/tailscale.md
+++ b/docs/reference/infrastructure/tailscale.md
@ -1,5 +1,5 @@
 ---
-title: tailscale
+title: Tailscale
 tags:
  - infrastructure
  - networking
--- a/docs/reference/infrastructure/title-test-alpha.md
+++ b/docs/reference/infrastructure/title-test-alpha.md
@ -1,13 +0,0 @@
---
-title: Title Test Card
-tags:
-  - infrastructure
-  - test
---
-
-# Title Test Card (Alpha)
-
-This card tests that duplicate frontmatter titles don't break wiki-link resolution.
-This card and [[title-test-beta]] share the same `title:` frontmatter value.
-
-If you can read both cards and the links work, the test passes.
--- a/docs/reference/infrastructure/title-test-beta.md
+++ b/docs/reference/infrastructure/title-test-beta.md
@ -1,13 +0,0 @@
---
-title: Title Test Card
-tags:
-  - infrastructure
-  - test
---
-
-# Title Test Card (Beta)
-
-This card tests that duplicate frontmatter titles don't break wiki-link resolution.
-This card and [[title-test-alpha]] share the same `title:` frontmatter value.
-
-If you can read both cards and the links work, the test passes.
--- a/docs/reference/kubernetes/apps.md
+++ b/docs/reference/kubernetes/apps.md
@ -1,5 +1,5 @@
 ---
-title: argocd-applications
+title: Apps
 tags:
  - kubernetes
  - argocd
--- a/docs/reference/kubernetes/cluster.md
+++ b/docs/reference/kubernetes/cluster.md
@ -1,5 +1,5 @@
 ---
-title: kubernetes-cluster
+title: Cluster
 tags:
  - kubernetes
 ---
--- a/docs/reference/kubernetes/external-secrets.md
+++ b/docs/reference/kubernetes/external-secrets.md
@ -1,5 +1,5 @@
 ---
-title: external-secrets
+title: External Secrets
 tags:
  - kubernetes
  - secrets
--- a/docs/reference/kubernetes/tailscale-operator.md
+++ b/docs/reference/kubernetes/tailscale-operator.md
@ -1,5 +1,5 @@
 ---
-title: tailscale-operator
+title: Tailscale Operator
 tags:
  - kubernetes
  - tailscale
--- a/docs/reference/operations/backup.md
+++ b/docs/reference/operations/backup.md
@ -1,5 +1,5 @@
 ---
-title: backup
+title: Backup
 tags:
  - operations
 ---
--- a/docs/reference/operations/disaster-recovery.md
+++ b/docs/reference/operations/disaster-recovery.md
@ -1,5 +1,5 @@
 ---
-title: disaster-recovery
+title: Disaster Recovery
 tags:
  - operations
 ---
--- a/docs/reference/operations/observability.md
+++ b/docs/reference/operations/observability.md
@ -1,5 +1,5 @@
 ---
-title: observability
+title: Observability
 tags:
  - operations
 ---
--- a/docs/reference/reference.md
+++ b/docs/reference/reference.md
@ -1,5 +1,5 @@
 ---
-title: reference
+title: Reference
 tags:
  - reference
 ---
@ -46,8 +46,6 @@ Host inventory and network configuration.
 - [[tailscale]] - ACLs, groups, tags
 - [[gandi]] - DNS hosting for `eblu.me`
 - [[routing|Routing]] - DNS domains, port mappings
- [[title-test-alpha]] / [[title-test-beta]] - Duplicate title test (temporary)
-
 ## Kubernetes

 Cluster configuration and application registry.
--- a/docs/reference/services/1password.md
+++ b/docs/reference/services/1password.md
@ -1,5 +1,5 @@
 ---
-title: 1password
+title: 1Password
 tags:
  - service
  - secrets
--- a/docs/reference/services/alloy.md
+++ b/docs/reference/services/alloy.md
@ -1,5 +1,5 @@
 ---
-title: grafana-alloy
+title: Alloy
 tags:
  - service
  - observability
--- a/docs/reference/services/argocd.md
+++ b/docs/reference/services/argocd.md
@ -1,5 +1,5 @@
 ---
-title: argocd
+title: ArgoCD
 tags:
  - service
  - gitops
--- a/docs/reference/services/automounter.md
+++ b/docs/reference/services/automounter.md
@ -1,5 +1,5 @@
 ---
-title: automounter
+title: Automounter
 tags:
  - services
  - macos
--- a/docs/reference/services/borgmatic.md
+++ b/docs/reference/services/borgmatic.md
@ -1,5 +1,5 @@
 ---
-title: borgmatic
+title: Borgmatic
 tags:
  - service
  - backup
--- a/docs/reference/services/caddy.md
+++ b/docs/reference/services/caddy.md
@ -1,5 +1,5 @@
 ---
-title: caddy
+title: Caddy
 tags:
  - service
  - networking
--- a/docs/reference/services/devpi.md
+++ b/docs/reference/services/devpi.md
@ -1,5 +1,5 @@
 ---
-title: devpi
+title: Devpi
 tags:
  - service
  - python
--- a/docs/reference/services/docs.md
+++ b/docs/reference/services/docs.md
@ -1,5 +1,5 @@
 ---
-title: docs
+title: Docs
 tags:
  - service
  - documentation
--- a/docs/reference/services/forgejo.md
+++ b/docs/reference/services/forgejo.md
@ -1,5 +1,5 @@
 ---
-title: forgejo
+title: Forgejo
 tags:
  - service
  - git
--- a/docs/reference/services/grafana.md
+++ b/docs/reference/services/grafana.md
@ -1,5 +1,5 @@
 ---
-title: grafana
+title: Grafana
 tags:
  - service
  - observability
--- a/docs/reference/services/immich.md
+++ b/docs/reference/services/immich.md
@ -1,5 +1,5 @@
 ---
-title: immich
+title: Immich
 tags:
  - service
  - media
--- a/docs/reference/services/jellyfin.md
+++ b/docs/reference/services/jellyfin.md
@ -1,5 +1,5 @@
 ---
-title: jellyfin
+title: Jellyfin
 tags:
  - service
  - media
--- a/docs/reference/services/kiwix.md
+++ b/docs/reference/services/kiwix.md
@ -1,5 +1,5 @@
 ---
-title: kiwix
+title: Kiwix
 tags:
  - service
  - knowledge
--- a/docs/reference/services/loki.md
+++ b/docs/reference/services/loki.md
@ -1,5 +1,5 @@
 ---
-title: loki
+title: Loki
 tags:
  - service
  - observability
--- a/docs/reference/services/miniflux.md
+++ b/docs/reference/services/miniflux.md
@ -1,5 +1,5 @@
 ---
-title: miniflux
+title: Miniflux
 tags:
  - service
  - rss
--- a/docs/reference/services/navidrome.md
+++ b/docs/reference/services/navidrome.md
@ -1,5 +1,5 @@
 ---
-title: navidrome
+title: Navidrome
 tags:
  - service
  - media
--- a/docs/reference/services/postgresql.md
+++ b/docs/reference/services/postgresql.md
@ -1,5 +1,5 @@
 ---
-title: postgresql
+title: PostgreSQL
 tags:
  - service
  - database
--- a/docs/reference/services/prometheus.md
+++ b/docs/reference/services/prometheus.md
@ -1,5 +1,5 @@
 ---
-title: prometheus
+title: Prometheus
 tags:
  - service
  - observability
--- a/docs/reference/services/teslamate.md
+++ b/docs/reference/services/teslamate.md
@ -1,5 +1,5 @@
 ---
-title: teslamate
+title: TeslaMate
 tags:
  - service
  - vehicle
--- a/docs/reference/services/transmission.md
+++ b/docs/reference/services/transmission.md
@ -1,5 +1,5 @@
 ---
-title: transmission
+title: Transmission
 tags:
  - service
  - torrent
--- a/docs/reference/services/zot.md
+++ b/docs/reference/services/zot.md
@ -1,5 +1,5 @@
 ---
-title: zot
+title: Zot
 tags:
  - service
  - registry
--- a/docs/reference/storage/backups.md
+++ b/docs/reference/storage/backups.md
@ -1,5 +1,5 @@
 ---
-title: backup-policy
+title: Backups
 tags:
  - storage
  - backup
--- a/docs/reference/storage/postgresql-storage.md
+++ b/docs/reference/storage/postgresql-storage.md
@ -1,5 +1,5 @@
 ---
-title: postgresql-storage
+title: PostgreSQL Storage
 tags:
  - storage
  - database
--- a/docs/reference/storage/sifaka.md
+++ b/docs/reference/storage/sifaka.md
@ -1,5 +1,5 @@
 ---
-title: sifaka-nas
+title: Sifaka
 tags:
  - storage
 ---
--- a/docs/tutorials/adding-a-service.md
+++ b/docs/tutorials/adding-a-service.md
@ -1,5 +1,5 @@
 ---
-title: adding-a-service
+title: Adding a Service
 tags:
  - tutorials
  - argocd
--- a/docs/tutorials/ai-assistance-guide.md
+++ b/docs/tutorials/ai-assistance-guide.md
@ -1,5 +1,5 @@
 ---
-title: ai-assistance-guide
+title: AI Assistance Guide
 tags:
  - tutorials
  - ai
--- a/docs/tutorials/contributing.md
+++ b/docs/tutorials/contributing.md
@ -1,5 +1,5 @@
 ---
-title: contributing
+title: Contributing
 tags:
  - tutorials
  - contributing
--- a/docs/tutorials/exploring-the-docs.md
+++ b/docs/tutorials/exploring-the-docs.md
@ -1,5 +1,5 @@
 ---
-title: exploring-the-docs
+title: Exploring the Docs
 tags:
  - tutorials
  - getting-started
--- a/docs/tutorials/replicating-blumeops.md
+++ b/docs/tutorials/replicating-blumeops.md
@ -1,5 +1,5 @@
 ---
-title: replicating-blumeops
+title: Replicating BlumeOps
 tags:
  - tutorials
  - replication
--- a/docs/tutorials/replication/argocd-config.md
+++ b/docs/tutorials/replication/argocd-config.md
@ -1,5 +1,5 @@
 ---
-title: argocd-config
+title: ArgoCD Config
 tags:
  - tutorials
  - replication
--- a/docs/tutorials/replication/core-services.md
+++ b/docs/tutorials/replication/core-services.md
@ -1,5 +1,5 @@
 ---
-title: core-services
+title: Core Services
 tags:
  - tutorials
  - replication
--- a/docs/tutorials/replication/kubernetes-bootstrap.md
+++ b/docs/tutorials/replication/kubernetes-bootstrap.md
@ -1,5 +1,5 @@
 ---
-title: kubernetes-bootstrap
+title: Kubernetes Bootstrap
 tags:
  - tutorials
  - replication
--- a/docs/tutorials/replication/observability-stack.md
+++ b/docs/tutorials/replication/observability-stack.md
@ -1,5 +1,5 @@
 ---
-title: observability-stack
+title: Observability Stack
 tags:
  - tutorials
  - replication
--- a/docs/tutorials/replication/tailscale-setup.md
+++ b/docs/tutorials/replication/tailscale-setup.md
@ -1,5 +1,5 @@
 ---
-title: tailscale-setup
+title: Tailscale Setup
 tags:
  - tutorials
  - replication
--- a/docs/tutorials/tutorials.md
+++ b/docs/tutorials/tutorials.md
@ -1,5 +1,5 @@
 ---
-title: tutorials
+title: Tutorials
 tags:
  - tutorials
 ---
				`@ -0,0 +1 @@`
				`Update all docs frontmatter titles from slug-case to human-readable and delete title-test cards.`