Clean up and document utils package

Thom Wiggers
2018-02-14T19:32:34+01:00

Closes #587

### Short description

* Documents the utils package
* Slightly cleans up the utils package
* Slightly refactor some tests to use `subTest`
* Enables intersphinx for Django