document... freaking... everything...
make golint required in travis CI