Improve documentation

[glaslos]

[davidt99]

I think we need to be more godoc friendly, because right now it doesn't explain much.

[glaslos]

Assigning this to myself.