Add make help descriptions and additional local dev utils

Author: mbeacom

Makefile

@@ -1,4 +1,32 @@
-.PHONY: compress-images
+# Help
+.DEFAULT_GOAL := help
 
-compress-images:
+.PHONY: help
+
+compress-images: ## Compress and optimize images throughout the repository. Requires optipng, svgo, and jpeg-recompress.
 	@./scripts/compress_images.bash
+
+eslint: ## Run eslint against the project directory. Requires node, npm, and project dependencies.
+	@npm run eslint
+
+fix-eslint: ## Run eslint --fix against the project directory. Requires node, npm, and project dependencies.
+	@npm run eslint:fix
+
+fix-isort: ## Run isort against python files in the project directory.
+	@docker-compose exec web isort -rc --atomic .
+
+fix: fix-eslint fix-isort ## Attempt to run all fixes against the project directory.
+
+fresh: ## Completely destroy all compose assets and start compose with a fresh build.
+	@docker-compose down -v; docker-compose up -d --build;
+
+logs: ## Print and actively tail the docker compose logs.
+	@docker-compose logs -f
+
+pytest: ## Run pytest (Backend)
+	@docker-compose exec web pytest -p no:ethereum
+
+tests: pytest eslint ## Run the full test suite.
+
+help:
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "\033[36m%-30s\033[0m %s\n", $$1, $$2}'

docs/RUNNING_LOCALLY_DOCKER.md

@@ -66,3 +66,50 @@ This can be useful if you'd like data to test with:
 ```shell
 docker-compose exec web python3 app/manage.py sync_geth mainnet 40 99999999999
 ```
+
+### FAQ
+
+#### Running Tests
+
+`Q: How can I run the tests locally?`
+
+You can ensure your project will pass all Travis tests by running:
+
+```shell
+make tests # docker-compose exec web pytest -p no:ethereum; npm run eslint;
+```
+
+The above make command will run `eslint` and `pytest`.
+
+#### Fresh rebuild
+
+`Q: My environment is erroring out due to missing modules/packages or postgresql errors. How can I fix it?`
+
+```shell
+make fresh # docker-compose down -v; docker-compose up -d --build;
+```
+
+#### Create superuser
+
+`Q: How can I access the django administration login?`
+
+```shell
+make superuser # docker-compose exec web python3 app/manage.py createsuperuser
+open http://localhost:8000/_administration
+```
+
+#### Fix local test issues
+
+`Q: How can I attempt automatic remediation of eslint and isort test failures?`
+
+```shell
+make fix # npm run eslint:fix; docker-compose exec web isort -rc --atomic .;
+```
+
+#### Makefile Help
+
+`Q: How can I see a complete list of Makefile commands and descriptions?`
+
+```shell
+make # make help
+```