The GitHub Issue Close Event is used to trigger a TODO when a GitHub Issue gets closed.

Example

# The following TODO will be ready to be addressed as soon as the Issue
# https://github.com/rails/rails/issues/7047 gets closed.

TODO(on: issue_close("rails", "rails", 7047))

Arguments

Number

The Issue Close event expects 3 arguments, in order:

  1. The GitHub owner of the repository
  2. The name of the repository
  3. The issue number

Authorization

The Issue Close event can only be created to watch private repositories belonging to the same repository owner where the TODO was pushed. This rule only applies to private repositories.


Examples

Consider these 3 examples, each todo being added to the stripe/stripe GitHub repository.

This TODO will be considered invalid as the Google repository is outside the Stripe organisation.

Invalid
TODO(on: issue_close("Google", "Google", 251))

This TODO will be considered valid as the private-repo repository is in the Stripe organisation.

Valid
TODO(on: issue_close("stripe", "private-repo", 123))

This TODO will be considered valid as the rails repository is a public repository.

Valid
TODO(on: issue_close("rails", "rails", 123))