prosebot[bot]

Probot App to help you write better on GitHub.

Usage

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:

What it checks

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.

Installation

Visit the installation page and install the GitHub App on your repositories. That's all there is to it ❤️

Configuration

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

Credits

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:

• write-good
• alex
• node-spellchecker
• node-markdown-spellcheck

Future work

• Using Suggested Changes to... suggest changes.
• Work on multiple PRs at a time
• Nicer annotations
• More providers? Open an issue!