Probot App to help you write better on GitHub.
After installing the GitHub App on your repos, this Probot App listens for changes to Markdown files (.md
) or text files (.txt
) in pull requests and runs various checks against them to provide feedback on the English. Currently, the app checks for spelling, prose and inclusive verbiage. This is done by leveraging existing open source libraries, which you can find listed below. Here's how it looks in action:
A non-exhaustive list of the various checks that are run:
- Correct spelling (and provides possible corrections).
- Use of non-inclusive/profane/offensive language.
- Various prose-related checks, find the full list here.
Visit the installation page and install the GitHub App on your repositories. That's all there is to it ❤️
There are currently three providers that the app uses to test your text. These can each be disabled, and are all enabled by default. To disable a provider, add a .github/prosebot.yml
file to your repository and set the provider to false
:
# .github/prosebot.yml
writeGood: true
alex: true
spellchecker: true
This Probot App is mostly a wrapper around existing open source libraries. The majority of the work is done by those, and they deserve a ton of thanks:
- Using Suggested Changes to... suggest changes.
- Work on multiple PRs at a time
- Nicer annotations
- More providers? Open an issue!