Update and clean up documentation

Summary: Resolves T299

Test Plan:
- Check `README.md`
- Check each file in `docs/`

Reviewers: doshitan

Reviewed By: doshitan

Maniphest Tasks: T299

Differential Revision: https://phabricator.opengovfoundation.org/D191

Author: sethetter

.env.example

@@ -4,7 +4,7 @@ APP_KEY=SomeRandomStringSomeRandomString
 APP_DEBUG=true
 APP_LOG_LEVEL=debug
 APP_NAME='Madison'
-APP_URL='http://mymadison.local'
+APP_URL='http://localhost:8000'
 
 DB_CONNECTION=mysql
 DB_HOST=localhost

README.md

@@ -1,11 +1,10 @@
 # Madison
 
-[![Build Status](https://api.travis-ci.org/opengovfoundation/madison.svg?branch=master)](https://travis-ci.org/opengovfoundation/madison)
-[![Scrutinizer Code Quality](https://img.shields.io/scrutinizer/g/opengovfoundation/madison.svg)](https://scrutinizer-ci.com/g/opengovfoundation/madison?branch=master)
+[![CircleCI](https://circleci.com/gh/opengovfoundation/madison/tree/master.svg?style=svg)](https://circleci.com/gh/opengovfoundation/madison/tree/master)
 
-Madison is an open-source, collaborative document editing platform.  While
+Madison is an open-source document engagement and feedback platform.  While
 Madison can be used to collaborate on many different kinds of documents, the
-official version is being built with legislative and policy documents in mind.
+official version is being built legislative and policy documents in mind.
 
 If you have questions about Madison, please open an issue and we will try to
 respond as soon as possible.
@@ -14,55 +13,16 @@ Check out the [Madison Documentation](https://github.com/opengovfoundation/madis
 or jump right into the [Issue Log](https://github.com/opengovfoundation/madison/issues)
 for more information on the project.
 
-We have created a new, public mailing list for Madison development in Google
-Groups that you might be interested in subscribing to. We'll be using this as
-the official channel for all Madison developer news, announcements, and chat
-from now on. (Though bugs should still be reported here on Github.) You can sign
-up for it here:
-
-[Madison Mailing List](https://groups.google.com/forum/#!forum/madison-developers)
-
-We have also created a very short survey to find out more about the developers
-using Madison. Please take a few minutes to fill out this survey so we can
-better understand what your needs are and who is using Madison:
-
-[Madison Developers Survey](http://goo.gl/forms/BV4Flc0zx7)
-
 ## Architecture
 
 As of 4.0, Madison is a generally plain Laravel (PHP) application.
 
-## Installation
-
-Please take a look at the `docs/INSTALL.md` or `docs/INSTALL.OSX.md` files for
-how to install Madison.
-
-## Customization
-
-There are a few different mechanisms for customizing Madison to your liking.
-
-### Language & i18n
-
-The majority of the language in the system is defined in the `client/app/locales/`
-folder within relevant JSON files, defined for each supported language. If you
-create a file that matches the necessary language name in
-`client/app/locales/custom/` this will overwrite what is set as default in the base
-language files.
-
-### Style
-
-Any stylesheets placed within the `client/app/sass/custom/` folder will be processed
-during the build and can overwrite any existing styles. You can also change sass
-variables here. Reference the sass config files in `client/app/sass/config/` to see
-what variables can be changed.
-
-## Test Suite
+## User Guide
 
-To run the tests, you will need to make sure to have a database created called
-`madison_testing`, then simply run `make test`.
+Visit our [Engagement Guide](https://mymadison.io/sponsors/guide)
+for information on using Madison to run engagement rounds.
 
-## How to help
+## How to Help
 
-* Open an issue, claim an issue, comment on an issue, or submit a pull request to resolve one
-* Document Madison - wiki documentation, installation guide, or docblocks internally
-* Clean up existing code - I'm sure we've taken shortcuts or added lazy code somewhere.
+Open an issue, claim an issue, comment on an issue, or submit a pull request to
+resolve one.

circle.yml

@@ -37,6 +37,7 @@ dependencies:
     # Setup environment for Apache
     - env | xargs -I {} echo "export '{}'" | sudo tee --append /etc/apache2/envvars > /dev/null
     # Install our config and make it active
+    - sed -i "s/{{REPO}}/$CIRCLE_PROJECT_REPONAME/g" circleci/apache.conf
     - sudo cp -f circleci/apache.conf /etc/apache2/sites-available/madison.conf
     - sudo a2enmod rewrite actions alias headers negotiation dir vhost_alias deflate
     - sudo a2ensite madison

circleci/apache.conf

@@ -1,9 +1,9 @@
 Listen 8888
 
 <VirtualHost *:8888>
-  DocumentRoot /home/ubuntu/madison-staging-area/public
+  DocumentRoot /home/ubuntu/{{REPO}}/public
 
-  <Directory /home/ubuntu/madison-staging-area/public>
+  <Directory /home/ubuntu/{{REPO}}/public>
       Options Indexes FollowSymLinks MultiViews ExecCGI
       DirectoryIndex index.php
       AllowOverride all