Improve documentation for documents

Thom Wiggers
2018-06-13T19:05:01+02:00

The ~documents module could use improved docs.