Clarify docs-scanner broken link rule to prevent 404s being filed as cross-reference issues

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
David Karlsson
2026-04-08 15:36:42 +02:00
parent 2c74da90db
commit ac4956f588
+4 -1
View File
@@ -108,7 +108,10 @@ agents:
## What not to file
- **Broken links** — htmltest catches these; do not file
- **Broken links** — htmltest catches these; do not file. This includes
links to non-existent files within the repo ("broken cross-reference"
is still a broken link). Only file if the URL resolves but the
surrounding prose misdescribes the destination.
- **Single time-relative words** in otherwise accurate sentences —
"currently", "recently", "still", "yet", "usually" — Vale already flags
these; your job is to find problems Vale can't see