Skip to content

ci: block casing mistakes in changed docs lines - #775

Open
hlenke wants to merge 3 commits into
mainfrom
docs/casing-lint
Open

hlenke wants to merge 3 commits into
mainfrom
docs/casing-lint

Conversation

@hlenke

@hlenke hlenke commented Oct 30, 2026

Copy link
Copy Markdown
Member

Adds a casing check to static-docs-checks that fails a PR when a line it adds or changes breaks the docs casing rules. Existing text elsewhere in a file never fails the check.

Rules (also in AGENTS.md under "Casing and terminology", so agents follow them while writing):

  • Headings, frontmatter title/sidebarTitle and component title="…" use sentence case. Acronyms and mixed-case names pass; other names that keep their capitals are listed in styles/Checkly/proper-nouns.txt.
  • Check and monitor types: Browser check, API check, Multistep check, URL monitor, Heartbeat monitor and the rest. "Playwright Check Suite" and "Agentic Check" stay as product names.
  • Single feature instances are lowercase ("a status page", "each private location").
  • Third-party names use official casing (GitHub, Node.js, OpenTelemetry, Opsgenie…).
  • Code, commands, URLs, bold UI labels and quoted text are skipped.

How: a styles/Checkly Vale style for the term rules, and .github/scripts/check-casing.mjs for sentence case. Run it locally with npm run lint:casing, or npm run lint:casing -- --all <file.mdx> for whole files.

Tested:

🤖 Generated with Claude Code

Adds a Checkly Vale style (check and monitor types, third-party names, single
feature instances) and a script that checks headings, frontmatter titles and
component titles for sentence case. Both run only on the lines a PR adds or
changes, so existing text never fails a PR. The rules are in AGENTS.md under
"Casing and terminology"; run them locally with npm run lint:casing.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
checkly-422f444a 🟢 Ready View Preview Oct 30, 2026, 9:29 PM

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

This branch was successfully deployed

1 active deployment
staging — d7266899 Deployed Oct 30, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant