GitHub as a talk proposal review system

code × February 4, 2018

For Ela Conf 2015, 2016, and 2017, we turned a private GitHub repository into a system for reviewing talk proposals.

Here’s how we set it up:

  1. We accepted proposals through a Google Form.
  2. Once someone submitted a proposal through our form, we set up a Zapier zap to create an issue in our repo.
  3. Our team used emoji reactions :+1: or :-1: on each proposal (issue) for the first round of review.

To help automate the process, I wrote a script that:

  1. Reads and formats the proposals (issues).
  2. Retrieves the emoji reactions for each proposal.
  3. Makes decisions for the proposal:

Below is a (highly) redacted example of a talk proposal with a 5 :+1: rating and a “favorite” label adhered by the bot!

screenshot of GitHub issue

The system and script worked very well for a small-scale (receiving around 200 proposals) conference that needed an asynchronous review period. We used labels to help organize the different types of proposals we received and left comments based on what we thought about the talk.

You can check out the code on GitHub.

Collate Google Form responses into Google Docs