ROpenSci :: Submit review

This responder can be used to update Airtable entries with a review url, duration and date in the reviews table. Once the number of reviews in Airtable equals the number of reviewers in the issue a message will be configured for 12 days later to remind authors to submit their response.

Listens to

@botname submit review <REVIEW_URL> time <REVIEW_HOURS>

Where <REVIEW_URL> must be a valid link to a comment in the issue and <REVIEW_HOURS> is numeric. For example:

@botname submit review https://github.com/ropensci/software-review/issues/338#issuecomment-536199121 time 7.5

Requirements

REVIEW_URL must be a complete url pointing to a comment in the review issue.

REVIEW_HOURS is numeric. Example of valid values: 4, 10.5, 7,5

Settings key

ropensci_submit_reviews

Params

label_when_all_reviews_in:: Optional Labeling to add to the issue once the number of reviews in Airtable equals the number of reviewers in the issue.
unlabel_when_all_reviews_in:: Optional Labeling to remove from the issue once the number of reviews in Airtable equals the number of reviewers in the issue.

For the Airtable connection to work two parameters must be present in the env section of the settings file, configured using environment variable:

...
  env:
    airtable_api_key: <%= ENV['AIRTABLE_API_KEY'] %>
    airtable_base_id: <%= ENV['AIRTABLE_BASE_ID'] %>
...

Examples

Simplest case:

...
  responders:
    ropensci_submit_reviews:
...

With labeling once all reviews are completed and limiting access to editors:

...
  responders:
    ropensci_submit_reviews:
      only:
        - editors
      label_when_all_reviews_in: "4/review-in-awaiting-changes"
      unlabel_when_all_reviews_in: "3/reviewer(s)-assigned"
...

In action

Invocation: Log first review

ROpenSci :: Submit review: first review in

Logging last review applies labeling: