Update docs with instructions for docker-compose

dev-tools/psql

@@ -1,4 +1,12 @@
 #!/bin/bash
+
+# Connect to the docker postgres database with the psql command line tool
+# without installing it locally
+#
+# Sample usage:
+#   * To open a shell: ./dev-tools/psql
+#   * Run a query:     ./dev-tools/psql  -c "SELECT COUNT(*) FROM campaign_contact"
+
 set -euo pipefail
 
 docker-compose exec postgres psql  -h localhost -p 5432 -U spoke spokedev "$@"

dev-tools/redis-cli

@@ -1,4 +1,11 @@
 #!/bin/bash
 set -euo pipefail
 
+# Connect to the docker redis instance with the redis-cli command line tool
+# without installing it locally.
+#
+# Sample usage:
+#   * To open a shell:    ./dev-tools/redis-cli
+#   * To clear the cache: ./dev-tools/redis-cli FLUSHDB
+
 docker-compose exec redis redis-cli "$@"

docs/EXPLANATION-development-guidelines.md

@@ -19,9 +19,9 @@ Generally, label by filename what kind of documentation it is in all-caps, one o
 * Reference
 
 ## Helpful Dev Tips
+
 * Run `sqlite3 mydb.sqlite` to connect to a SQL shell for the dev database
 * [Set up an ESLint plugin in your code editor so that you catch coding errors and follow code style guidelines more easily!](https://medium.com/planet-arkency/catch-mistakes-before-you-run-you-javascript-code-6e524c36f0c8#.oboqsse48)
-* [Install the redux-devtools-extension](https://github.com/zalmoxisus/redux-devtools-extension) in Chrome to get advanced Redux debugging features.
 
 ## Dependency Management
 

docs/HOWTO-run_tests.md

@@ -2,6 +2,14 @@ There are current two ways to run tests, using either PostgreSQL or SQLite.
 
 ## PostgreSQL Testing (default, closer to most prod environments)
 
+### Running Postgres with Docker (recommended)
+
+1. Install [Docker](https://docs.docker.com/desktop/)
+2. Run redis and postgres using docker-compose: `docker-compose up`
+3. Create the test database: `./dev-tools/create-test-database`
+4. Run `yarn test`
+
+### Installing Postgres locally
 1) Install PostgreSQL - [Tips to installing Postgres](https://www.codementor.io/engineerapart/getting-started-with-postgresql-on-mac-osx-are8jcopb)
 2) In PostgreSQL, create a database and user named "spoke_test":
 ```

docs/HOWTO_USE_POSTGRESQL.md

@@ -2,8 +2,10 @@
 
 To use Postgresql, follow these steps:
 
+1. Either install docker (recommended) or postgresql on your machine:
+   * If you installed docker run the database using: `docker-compose up`
+   * If you installed postgres locally, create the spoke dev database: `psql -c "create database spokedev;"`
 1. In `.env` set `DB_TYPE=pg`. (Otherwise, you will use sqlite.)
 2. Set `DB_PORT=5432`, which is the default port for Postgres.
-3. Create the spokedev database:  `psql -c "create database spokedev;"`
 
-That's all you need to do initially. The tables will be created the first time the app runs.
+That's all you need to do initially. The tables will be created the first time the app runs.