2 files changed, 31 insertions, 10 deletions
diff --git a/docs/README.md b/docs/README.md
index 6bef9c3c..2e9f15a1 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,8 +1,13 @@
 # Documentation
+
 This directory contains useful documentation for working with and using our site.
 
 ## Table of contents
+
 * [Setup guide](setup.md)
+
   * [PostgreSQL setup](setup.md#postgresql-setup)
+
   * [Development with Docker](setup.md#development-with-docker)
+
   * [Development with `pip`](setup.md#development-with-pip)
diff --git a/docs/setup.md b/docs/setup.md
index 16fb44d3..d6e5a7bf 100644
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -1,41 +1,55 @@
 # Setup
-Setting up the Python site for local development is quick and easy using `pip`.
-Alternatively, you can set it up using Docker. Both of these methods are documented here.
+
+Setting up the Python site for local development
+is quick and easy using `pip`.
+Alternatively, you can set it up using Docker.
+Both of these methods are documented here.
 
 ## PostgreSQL setup
-Install PostgreSQL according to its documentation. Then, create databases and users:
+
+Install PostgreSQL according to its documentation.
+Then, create databases and users:
+
 ```sql
 $ psql -qd postgres
 postgres=# CREATE USER pysite WITH CREATEDB;
 postgres=# CREATE DATABASE pysite OWNER pysite;
 ```
-Using different databases for development and tests is recommended because Django
+
+Using different databases for development
+and tests is recommended because Django
 will expect an empty database when running tests.
 Now that PostgreSQL is set up, simply set the proper database URL
 in your environment variables:
+
 ```sh
-$ export DATABASE_URL=postgres://pysite@localhost/pysite
+export DATABASE_URL=postgres://pysite@localhost/pysite
 ```
+
 A simpler approach to automatically configuring this might come in the
 near future - if you have any suggestions, please let us know!
 
 ## Development with Docker
+
 To quickly set up the site locally, you can use Docker.
-You will need Docker itself and `docker-compose` - you can omit the latter if you want to
-use PostgreSQL on your host. Refer to the docker documentation on how to install Docker.
+You will need Docker itself and `docker-compose` -
+you can omit the latter if you want to use PostgreSQL on
+your host. Refer to the docker documentation on how to install Docker.
 
 If you want to set the site up using `docker-compose`, simply run
+
 ```sh
-$ docker-compose up
+docker-compose up
 ```
+
 and it will do its magic.
 
 Otherwise, you need to set a bunch of environment variables (or pass them along to
 the container). You will also need to have a running PostgreSQL instance if you want
 to run on your host's PostgreSQL instance.
 
-
 ## Development with `pip`
+
 This is the recommended way if you wish to quickly test your changes and don't want
 the overhead that Docker brings.
 
@@ -45,9 +59,11 @@ using pip and virtualenv](https://packaging.python.org/guides/installing-using-p
 from the Python Packaging User Guide.
 
 Enter the virtual environment. Now you can run
+
 ```sh
-$ pip install -e .[lint,test]
+pip install -e .[lint,test]
 ```
+
 to install base dependencies along with lint and test dependencies.
 
 You can either use `python manage.py` directly, or you can use the console