documentation and golint

Improve documentation for exported identifiers.
closes #30