Switch to title-based wiki-links (#91)

## Summary
- Remove aliases from all zk cards to prevent them from capturing wiki-links
- Convert all wiki-links from `[[filename|Title]]` to `[[Title]]` format
- Replace `doc-filenames` task with `doc-titles` for duplicate title detection
- Update pre-commit hook to use `doc-titles`

Wiki-links now resolve to reference docs by their frontmatter title, which is more readable and maintainable than filename-based links.

## Deployment and Testing
- [x] Pre-commit hooks pass (including new `doc-titles` check)
- [x] Manually verified zk cards have aliases removed
- [ ] Deploy docs v1.0.7 and verify wiki-links resolve correctly
- [ ] Test links to reference docs (e.g., [[Grafana Alloy]], [[ArgoCD]])

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/91
This commit is contained in:
Erich Blume 2026-02-03 15:55:31 -08:00
commit 01adc4cf0f
56 changed files with 501 additions and 431 deletions

View file

@ -89,12 +89,22 @@ repos:
args: ['-config-file', '.github/actionlint.yaml']
files: ^\.forgejo/workflows/
# Documentation - check for duplicate filenames (required for Quartz shortest path resolution)
# Documentation - check for duplicate titles (required for Quartz wiki-link resolution)
- repo: local
hooks:
- id: doc-filenames
name: doc-filenames
entry: mise run doc-filenames
- id: doc-titles
name: doc-titles
entry: mise run doc-titles
language: system
files: ^docs/.*\.md$
pass_filenames: false
# Documentation - validate wiki-links point to existing titles
- repo: local
hooks:
- id: doc-links
name: doc-links
entry: mise run doc-links
language: system
files: ^docs/.*\.md$
pass_filenames: false