Skip to content

behaviorbot/update-docs

Repository files navigation

update-docs

a GitHub App built with probot that comments on newly opened Pull Requests that do not update either the README or a file in the /docs folder.

screen shot 2017-07-12 at 2 59 22 pm

Usage

  1. Install the bot on the intended repositories. The plugin requires the following Permissions and Events:
  • Pull requests: Read & Write
    • check the box for Pull Request events
  1. Add a .github/config.yml file that contains the contents you would like to reply within an updateDocsComment
  2. Optionally, you can also add a whiteList that includes terms, that if found in the title, the bot will not comment on.
  3. Optionally, you can also add targetFiles that includes the files or paths to consider documentation.
# Configuration for update-docs - https://github.com/behaviorbot/update-docs

# Comment to be posted to on PRs that don't update documentation
updateDocsComment: >
  Thanks for opening this pull request! The maintainers of this repository would appreciate it if you would update some of our documentation based on your changes.

updateDocsWhiteList:
  - bug
  - chore

updateDocsTargetFiles:
  - README
  - docs/

Setup

# Install dependencies
npm install

# Run the bot
npm start

See the probot deployment docs if you would like to run your own instance of this plugin.

About

Prompts users to include documentation in pull requests

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published