https://github.com/upbound/vale
https://github.com/upbound/vale
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/upbound/vale
- Owner: upbound
- License: mit
- Created: 2022-08-03T14:41:08.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-02-10T17:41:40.000Z (over 3 years ago)
- Last Synced: 2025-01-25T10:12:48.814Z (over 1 year ago)
- Size: 127 KB
- Stars: 3
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
This repository the home for the Upbound implementation of [Vale](https://vale.sh/).
## What's Vale
Vale is an [open source](https://github.com/errata-ai/vale) command-line tool to provide English language linting. Vale enables spell checking, writing improvements and style guide enforcement in files across text and code.
Vale uses "Packages" to define the set of rules for writing to follow.
## Upbound's use of Vale
Upbound uses the following Vale packages:
- [alex](https://github.com/get-alex/alex) - Catch insensitive, inconsiderate writing.
- [proselint](https://github.com/amperser/proselint/) - to try and improve writing styles.
- [Google](https://developers.google.com/style/) - the Google style guide for their Developer Documentation.
- [Microsoft](https://learn.microsoft.com/en-us/style-guide/welcome/) - based on the Microsoft Writing Style Guide.
- [write-good](https://github.com/btford/write-good) - Naive linter for English prose for developers who can't write good and wanna learn to do other stuff good too.
- [GitLab](https://gitlab.com/gitlab-org/gitlab/-/tree/master/doc/.vale) - The GitLab style guide.
## Warnings and errors
Upbound treats warnings and errors the same. All Vale tests must pass for approval.
## Contributing and customizing
Upbound welcomes contributions and changes to the `main` branch.
Use these guidelines for contributions:
- Edit existing packages first. This includes removing duplicate rules (common with `Google` and `Microsoft`), [adding acronyms](https://github.com/upbound/vale/blob/main/styles/gitlab/Uppercase.yml).
- Add Upbound specific words to the Upbound [Spelling file](https://github.com/upbound/vale/blob/main/styles/Upbound/spelling-exceptions.txt).
- Try to keep any modified lists in a case-insensitive alphabetical order.