Written here, linted here — every post ships with Vale's own report on it. Subscribe with RSS.
Joseph Kato · Latest
The Rubin Science Platform's docs run Google's style, two house rules, and a vocabulary built from a full spelling pass. Every finding is a suggestion to the writer, never a failed build, and the config explains each choice.
0 alerts grade 8.4 1,604 words 8 min
Joseph Kato ·
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
Joseph Kato ·
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 ·
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 ·
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 ·
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 ·
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 ·
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 ·
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 ·
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