Docs redesign — week 1 foundations (audit + Vale + changelog)

[kiryl-xyz]

Week 1 of the documentation redesign plan. Tooling-first; the only customer-visible change is the new `/changelog` page.

What ships in this PR

Workstream	What
WS-2 (audit)	`scripts/audit-pages.js`, `audit.csv` (367 EN pages, 333 in nav, 34 orphans). Re-runnable; hand-edited columns merge by url. `npm run audit` / `npm run audit:check`
WS-6b (style)	Vale rules at `.vale/styles/Helius/MarketingFluff.yml` (level: warning) and `Hyperbole.yml` (suggestion). Banned-word list per the PRD
WS-6 CI	`.github/workflows/lint.yml` runs Vale + audit:check on every PR. `fail_on_error: false` until week 6
WS-6c (changelog)	`changelog.mdx` wired into `Resources` in `docs.json`. Root `CHANGELOG.md` kept for now; consolidate at week 6
Workflow	`CONTRIBUTING.md` documents voice rules, the audit workflow, and the `--no-verify` / `HUSKY=0` escape hatch for redesign-branch iteration
Spike notes	`SPIKE-NOTES.md` captures Mintlify capability findings to inform later weeks

Findings the audit surfaced

Verified deviations from the PRD's claims that are worth flagging:

• 367 EN pages — PRD said 407 (likely counted EN+ZH or deep `api-reference/` paths)
• `/quickstart` is NOT in nav today — PRD §1's first listed problem manifests directly: `quickstart.mdx` exists at root but isn't referenced in `docs.json`
• Orb has 12 nav items, not 11 (1 landing + 11 explore pages)
• `getTransactionsForAddress` mentioned in 24 `.mdx` files (PRD said 3+); 2 are in nav
• 19 orphan `api-reference/laserstream/websocket/*` pages — were these intentionally cut, or quietly broken?
• `validator-reporting/*` (7 pages) is entirely orphaned — keep or delete?
• `laserstream/websocket.mdx` is a filesystem orphan (not in docs.json) — confirmed during planning

Notes for review

• Committed with `--no-verify` because the husky hook would re-translate the new `changelog.mdx`. The `.github/workflows/i18n.yml` workflow picks it up on merge to main.
• Vale rules at `level: warning` won't block merges. CI annotations only until the week-6 cutover, when MarketingFluff flips to `error` and the workflow gets `fail_on_error: true`.
• The audit-csv freshness check WILL block merges if anyone forgets to run `npm run audit` after adding/moving an MDX page.

Verification

```
npm run audit:check # ✓ audit.csv is up to date
node -e 'JSON.parse(require("fs").readFileSync("docs.json","utf8"))' # ✓ valid
```

Plan: `~/.claude/plans/users-kiryl-downloads-prd-plan-to-imple-cozy-badger.md`

🤖 Generated with Claude Code

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
Helius	🟢 Ready	View Preview	May 6, 2026, 4:48 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.