eblume/blumeops
1
1
Fork 0
Code Issues Pull requests Projects Releases 83 Packages Wiki Activity Actions

Rename doc-* mise tasks to docs-check-* / docs-review-* (#113)

Browse source 
## Summary
- Rename 4 automated-check tasks: `doc-titles` → `docs-check-titles`, `doc-filenames` → `docs-check-filenames`, `doc-links` → `docs-check-links`, `doc-index` → `docs-check-index`
- Rename 3 interactive-review tasks: `doc-random` → `docs-review-random`, `doc-tags` → `docs-review-tags`, `doc-stale` → `docs-review-stale`
- Update all references in `.pre-commit-config.yaml`, `ai-assistance-guide.md`, and `review-documentation.md`
- Historical changelog entries left as-is

## Test plan
- [x] `mise run docs-check-titles` exits 0
- [x] `mise run docs-check-links` exits 0
- [x] `mise run docs-review-tags` exits 0
- [x] `mise run doc-titles` fails with "no task found"
- [x] All pre-commit hooks pass (including renamed hook IDs)

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

Reviewed-on: https://forge.ops.eblu.me/eblume/blumeops/pulls/113
This commit is contained in:
Erich Blume 2026-02-06 07:08:46 -08:00
commit cb343a2e35
11 changed files with 30 additions and 29 deletions
Download patch file Download diff file Expand all files Collapse all files

1
docs/changelog.d/rename-doc-tasks.misc.md Normal file
View file

@ -0,0 +1 @@
Rename `doc-*` mise tasks to `docs-check-*` / `docs-review-*` for clearer naming convention.

6
docs/how-to/knowledgebase/review-documentation.md
View file

@ -15,7 +15,7 @@ How to periodically review and maintain the BlumeOps knowledge base.
Select a random documentation card for review:
```bash
mise run doc-random
mise run docs-review-random
```
This displays a random card with a review checklist to guide your assessment.
@ -74,7 +74,7 @@ If changes are pending, investigate whether docs or infrastructure is stale.
## When to Review
Consider running `mise run doc-random` during:
Consider running `mise run docs-review-random` during:
- Start of work sessions (quick maintenance)
- After major infrastructure changes (verify docs reflect reality)
@ -86,7 +86,7 @@ If a card needs updates:
1. Create a feature branch
2. Make the edits
3. Run `mise run doc-links` to verify links
3. Run `mise run docs-check-links` to verify links
4. Create a PR for review
See [[update-documentation]] for publishing changes.

14
docs/tutorials/ai-assistance-guide.md
View file

@ -94,13 +94,13 @@ BlumeOps operations are driven by mise tasks. Run `mise tasks` to list all avail
| `dns-up` | Apply DNS changes via Pulumi |
| `tailnet-preview` | Preview Tailscale ACL changes |
| `tailnet-up` | Apply Tailscale ACL changes via Pulumi |
| `doc-links` | Validate wiki-links in documentation (includes orphan detection) |
| `doc-index` | Check every doc is referenced in its category index |
| `doc-titles` | Check for duplicate doc titles |
| `doc-filenames` | Check for duplicate doc filenames |
| `doc-stale` | Report docs by last-modified date, highlight stale ones |
| `doc-tags` | Print frontmatter tag inventory across all docs |
| `doc-random` | Select a random doc card for review |
| `docs-check-links` | Validate wiki-links in documentation (includes orphan detection) |
| `docs-check-index` | Check every doc is referenced in its category index |
| `docs-check-titles` | Check for duplicate doc titles |
| `docs-check-filenames` | Check for duplicate doc filenames |
| `docs-review-stale` | Report docs by last-modified date, highlight stale ones |
| `docs-review-tags` | Print frontmatter tag inventory across all docs |
| `docs-review-random` | Select a random doc card for review |
| `indri-runner-logs` | View Forgejo workflow logs from local runner |
For ArgoCD operations, use the `argocd` CLI directly: