https://vale.sh/blog Notes from building Vale. en-us https://vale.sh/blog/testing-rules https://vale.sh/blog/testing-rules Keep test cases beside your rules, script rules included, and run them in CI. A rule that matches nothing no longer fails in silence. Joseph Kato Thu, 01 Oct 2026 00:00:00 GMT Tutorials A failing vale test case: the expected alert at line 9 against the actual one at line 7. https://vale.sh/blog/case-study-epic-lore https://vale.sh/blog/case-study-epic-lore 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. Joseph Kato Mon, 28 Sep 2026 00:00:00 GMT Case studies Adopters A Vale rule that replaces the Git term "working copy" with the Lore term "working tree". https://vale.sh/blog/case-study-gov-uk https://vale.sh/blog/case-study-gov-uk 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. Joseph Kato Mon, 28 Sep 2026 00:00:00 GMT Case studies Adopters The GOV.UK crest over the public sector's orbit pattern. https://vale.sh/blog/diataxis https://vale.sh/blog/diataxis 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. Joseph Kato Thu, 24 Sep 2026 00:00:00 GMT Packages A two-by-two grid of the four kinds of documentation, each cell with one alert where the page slipped into another kind. https://vale.sh/blog/journals https://vale.sh/blog/journals 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. Joseph Kato Thu, 17 Sep 2026 00:00:00 GMT Packages Formats A manuscript in a terminal window, its headings lit as sections, with one alert on a unit and one on the Methods heading. https://vale.sh/blog/commits https://vale.sh/blog/commits 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. Joseph Kato Thu, 10 Sep 2026 00:00:00 GMT Packages Formats A commit message with its subject, body, and trailers each highlighted as a separate scope, one carrying an alert at its exact column. https://vale.sh/blog/std https://vale.sh/blog/std General-purpose rules you extend to build your own style, extracted from the styles teams already run. Joseph Kato Wed, 02 Sep 2026 00:00:00 GMT Packages The Std directory tree, six rule families under one root, in a terminal window. https://vale.sh/blog/voices https://vale.sh/blog/voices The writing skill you would reach for, rewritten as Vale rules. Checked on every draft rather than remembered, and free until something breaks one. Joseph Kato Wed, 02 Sep 2026 00:00:00 GMT Packages Agents A token meter showing two prompt-sized bars, one alert-sized bar, and a zero. https://vale.sh/blog/openapi https://vale.sh/blog/openapi A tutorial on linting OpenAPI Specification files: extract just the prose from a structured file, with errors reported at their exact location. Joseph Kato Fri, 13 Mar 2026 00:00:00 GMT Tutorials Formats A YAML document with only its prose fields highlighted, one carrying an alert at its exact location.