git.cworth.org Git - turbot/blob - README

   1 Turbot: Slack automation for the Halibut that Bass team to do puzzle hunts
   2
   3 Turbot is a Slack integration which facilitates puzzle tracking,
   4 spreadsheet creation, and other useful features for remote
   5 collaboration.
   6
   7 From the user point of view, all functionality is available in Slack
   8 by means of the "Turbot" App and Slack commands such as "/new",
   9 "/edit", "/state", "/solved", "/tag", "/hunt", "/round", "puzzle", and
  10 "/rot". Each command has some built-in documentation (just type the
  11 command to see it) and the "/help" command gives an overview of all
  12 commands. Additionally "/help <command>" can be used to get help on
  13 any command.
  14
  15 There is also a user document that we plan to add to this repository.
  16
  17 From the developer point of view, the code is implemented as a set of
  18 AWS Lambda functions as well as the configuration of the Slack app to
  19 invoke the correct functions.
  20
  21 There are a few places where pieces are deployed or configured:
  22
  23   * The AWS account is associated with a root login of
  24     crwth@puzzlers.org. If you need access to this account, just ask
  25     Carl at that email and he'll help you out.
  26
  27   * The Google docs for the spreadsheet template and for every
  28     puzzle-specific spreadsheet are stored in a Google account for the
  29     email address turbot@cworth.org . Again Carl will be happy to
  30     share these out to anyone, (including sharing the hunt-specific
  31     Google drive directory containing all the sheets for a specific
  32     hunt to everyone in the hunt).
  33
  34   * The Turbot Slack app is maintained at the following URL:
  35     https://api.slack.com/apps/A01B6C96E21 This is where the AWS
  36     Lambda URLs are configured for specific slash commands, etc.
  37
  38   * Finally, any particular Slack instance using Turbot needs to add
  39     the Turbot app which is under "Settings and Administration ->
  40     Manage Apps" available for any Slack user that is an admin for
  41     that particular Slack instance.
  42
  43 If you have feedback or questions about Turbot, please direct them to
  44 crwth@puzzlers.org or find Carl Worth (Crwth) in Slack and he can
  45 invite you to the #tech-planning channel where development details are
  46 discussed.