Skip to content

Templater

GitHub App

Templater

GitHub App

Templater

Templater

A GitHub App built with Probot that requests more info from newly opened Pull Requests and Issues that contain either default titles, whose description is left blank or templates not followed. It does so by taking data from a .github/config.yml.

screen shot 2017-07-07 at 3 32 01 pm

NOTE: This is a customised implementation of request-info and follows a lot of the similar principals. The idea is to improve the code from request info to stringently enforce the template.

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
  • Issues: Read & Write
    • check the box for Issue events
  • Content: Read
    • check the box for Content events
  1. Add a .github/config.yml file that contains the following:
# Configuration for Templater - https://github.com/rohitjmathew/probot-template-enforcer

# *OPTIONAL* Comment to reply with
# Can be either a string :
probotTemplateEnforcerReplyComment: >
  We would appreciate it if you could provide us with more info about this issue/pr!

# Or an array:
# probotTemplateEnforcerReplyComment:
#  - Ah no! young blade! That was a trifle short!
#  - Tell me more !
#  - I am sure you can be more effusive


# *OPTIONAL* default titles to check against for lack of descriptiveness
# MUST BE ALL LOWERCASE
probotTemplateEnforcerDefaultTitles:
  - update readme.md
  - updates

# *OPTIONAL* Label to be added to Issues and Pull Requests with insufficient information given
probotTemplateEnforcerLabelToAdd: needs-more-info

# *OPTIONAL* Require Issues to contain more information than what is provided in the issue templates
# Will fail if the issue's body is equal to a provided template
checkIssueTemplate: true

# *OPTIONAL* Require Pull Requests to contain more information than what is provided in the PR template
# Will fail if the pull request's body is equal to the provided template
checkPullRequestTemplate: true

# *OPTIONAL* Only warn about insufficient information on these events type
# Keys must be lowercase. Valid values are 'issue' and 'pullRequest'
probotTemplateEnforcerOn:
  pullRequest: true
  issue: true

# *OPTIONAL* Add a list of people whose Issues/PRs will not be commented on
# keys must be GitHub usernames
probotTemplateEnforcerUserstoExclude:
  - hiimbex
  - rohitjmathew

Developer

Templater is provided by a third-party and is governed by separate terms of service, privacy policy, and support documentation.

Report abuse