Joseph Kato · Latest
Testing your rules with vale test
Keep test cases beside your rules, script rules included, and run them in CI. A rule that matches nothing no longer fails in silence.
0 alerts grade 6.2 785 words 4 min
Featured Read the post
Vale CMS Need more than a rule playground? Author full projects — config, rules, vocabularies, and tests. Explore
The Vale blog 9
posts · 10,066 words · 0 alerts
Notes from building Vale.
Written here, linted here — every post ships with Vale's own report on it. Subscribe with RSS.
Joseph Kato ·
How Epic Games keeps Lore from sounding like Git
Lore is Epic's open source version control system, and its docs run a 62-rule Vale style whose job is to make a new product speak its own language. The config, the rules, and the script that runs them.
0 alerts grade 8.6 1,062 words 5 min
Joseph Kato ·
How GOV.UK turned its style guide into a build step
The UK government's plain-English rules, packaged as a Vale style, run by ten GOV.UK One Login repositories, and wired into an Android app's Gradle build so the source comments are checked too.
0 alerts grade 8.5 944 words 5 min
Joseph Kato ·
Linting the four kinds of documentation
Diataxis is a Vale package for the four kinds of documentation in Diátaxis: tutorials, how-to guides, reference, and explanation, each checked against the job it claims to do.
0 alerts grade 8.9 1,115 words 6 min
Joseph Kato ·
Linting a manuscript
Journals is a Vale package for scientific papers: the conventions every journal shares, the Nature and PLOS ONE author guidelines, and the CONSORT, STROBE, and PRISMA checklists, read section by section.
0 alerts grade 8.5 1,371 words 7 min
Joseph Kato ·
Linting commit messages
Commits is a Vale package for the log: nine conventions, the rule sets of commitlint, gitlint, committed, conform, and commitizen, spelling on the body, and a hook that runs in 12 ms.
0 alerts grade 7.6 1,289 words 6 min
Joseph Kato ·
Introducing Std: The standard library for Vale
General-purpose rules you extend to build your own style, extracted from the styles teams already run.
0 alerts grade 6.9 1,051 words 5 min
Joseph Kato ·
Introducing Voices: AI writing skills as Vale rules
The writing skill you would reach for, rewritten as Vale rules. Checked on every draft rather than remembered, and free until something breaks one.
0 alerts grade 6.5 1,762 words 9 min
Joseph Kato ·
Vale and the OpenAPI Specification
A tutorial on linting OpenAPI Specification files: extract just the prose from a structured file, with errors reported at their exact location.
0 alerts grade 9.6 687 words 3 min