Improve documentation for the utils module

Thom Wiggers
2018-02-21T19:14:33+01:00

The `utils` module could use improved docs.