packages
packages copied to clipboard
:package: A collection of pre-packaged, Vale-compatible style guides and configurations.
Styles 
This repository contains a library of all officially supported styles for Vale and Vale Server.
| Vale | Vale Server |
|---|---|
|
|
| Vale is an open-source, command-line linter for prose. It's fast, syntax-aware, and extensible. | Vale Server is a commercial desktop application (macOS and Windows) that enhances and refines the Vale experience. |
The benefits of using these styles over their original implementations include:
- [X] Improved support for markup, including the ability to ignore code and target only certain sections of text (e.g., checking headers for a specific capitalization style).
- [X] No need to install and configure npm (Node.js), pip (Python), or other language-specific tools. With Vale, you get all the functionality in a single, standalone binary available for Windows, macOS, and Linux.
- [X] Easily combine, mismatch, or otherwise customize each style.
Available styles
Microsoft- An implementation of the Microsoft Writing Style Guide.
Google- An implementation of the Google Developer Documentation Style Guide.
write-good- An implementation of the guidelines enforced by the
write-goodlinter. proselint- An implementation of the guidelines enforced by the
proselintlinter. Joblint- An implementation of the guidelines enforced by the
Joblintlinter. alex- An implementation of the guidelines enforced by the
alexlinter. Readability- An implementations of many popular "readability" metrics.
Requirements
All styles in this library must (1) be maintained in their own (dedicated) repository, (2) publish releases following Semantic Versioning, and (3) include a meta.json file with the following structure:
{
"feed": "...",
"vale_version": "..."
}
where feed is an Atom-formatted release feed (e.g., https://github.com/<USER>/<REPO>/releases.atom) and vale_version is the minimum required Vale version (e.g., v1.0.0).
Submitting a style
Fork this repo, add an entry (in alphabetical order) to the library.json file, and submit a PR.