A maintainable web app for the U.S. Go Congress. Copyright (c) 2010-2021 American Go Association

Nate Eagle is the current U.S. Go Congress webmaster. You can email him or create an issue here with any questions, concerns, or feedback. Contributions to the site are welcome and encouraged: if you know some Ruby, JavaScript, or even just HTML/CSS, creating a pull request is a great way to become part of the team.

1. Prerequisites
   1. Linux (eg. Ubuntu 16.04+) or Mac OS 10.8+
   2. Proficiency with git and sql
   3. Read Getting Started with Rails
   4. Fork and clone this github repo
2. Install the Ruby version specified in .ruby-version.
   • Use rbenv or compile from source
3. Install PostgreSQL 9.4.4+
   1. Practice connecting using the command-line client, psql
      • "permission denied"
      • Client Connection Problems
   2. Make sure you have a role that can create tables
4. App dependencies
   1. Install a js runtime
      • macs come with JavaScriptCore (part of webkit)
      • linux or mac: node (apt-get nodejs)
   2. Install ImageMagick CLI
      • eg. brew install imagemagick
      • Make sure CLI tools are on your PATH with eg. which convert
   3. Install ruby gems using bundler
      1. gem install bundler --version '1.17'
      2. bundle install
      3. If a gem fails to install, it may be missing native libraries
         1. nokogiri needs libxml2 and libxslt
         2. pg needs libpq-dev
5. App configuration
   1. Configure rails to talk to your database
      1. cp config/database.example.yml config/database.yml
   2. cp .env.example .env (see Configuration below)
   3. If all is well, bin/rake -T should list rake tasks
6. Run the tests
   1. bin/rails db:setup
   2. bin/rails db:test:prepare
   3. bin/rake will run the tests. If they all pass, you're good to go.
7. Submit your contribution
   1. Write a spec that describes your contribution
   2. Push your changes to your fork on github
   3. Submit a pull request

ENV variables are stored in a .env file, which is git-ignored. Most of these variables don't belong in source control because they are secret. Others vary by deployment level. This file will be loaded by the dotenv gem.

For local development, cp .env.example .env to get started. For stage and production use heroku config.

See doc/smtp.md

Email for accounts in the gocongress.org domain is managed through Google Apps. [email protected] has access to manage these accounts.

Special thanks to Lisa Scott, who helped invent, and tirelessly tested, the first year's site in 2011. Special thanks to Jared Beck, who provided mentoring and assistance for the 2014 site. Special thanks to Tim Hoel and Jared Beck who both provided mentoring and assistance for the 2015 site. Special thanks to Rex Cristal, for taking over maintenance of the site from 2015 – 2019!

• 2019: Gregory Steltenpohl, Nate Eagle, Steve Colburn, Lisa Scott, Dave Weimer
• 2018: Nate Eagle, Joel Cahalan, Steve Colburn, Andrew Jackson
• 2017: Andrew Jackson, Jared Beck, Steve Colburn, Lisa Scott, Ted Terpstra, Les Lanphear
• 2016: Rex Cristal, Walther Chen, Sun Chun
• 2015: Tim Hoel, Jared Beck, Andrew Jackson, Josh Larson, Steve Colburn, Rex Cristal
• 2014: Jared Beck, Andrew Jackson, Matthew Hershberger, Chris Kirschner, Steve Colburn, Rex Cristal
• 2013: Chris Kirschner, Judy Debel
• 2012: Arlene Bridges, Bob Bacon, Steve Colburn
• 2011: Lisa Scott, Alf Mikula, Brian David, Andrew Jackson, Steve Colburn