Switch to title-based wiki-links #91

Merged
eblume merged 2 commits from feature/title-based-links into main 2026-02-03 15:55:32 -08:00
Owner

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

  • Pre-commit hooks pass (including new doc-titles check)
  • 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

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Add mise-tasks/doc-links script to check all wiki-links point to valid titles
- Add doc-links pre-commit hook
- Add frontmatter title to README.md for wiki-link resolution
- Filter out wiki-links inside backticks (code examples)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
eblume merged commit 01adc4cf0f into main 2026-02-03 15:55:32 -08:00
eblume referenced this pull request from a commit 2026-02-03 15:55:33 -08:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
eblume/blumeops!91
No description provided.