Fixes

Various little improvements. I tried to keep the commits small and coherent, so you can easily cherry-pick.
ah. I guess I may not be completely up-to-date.

well, this other nice godoc-article seems to also prefer the effective_go practice rather than the wiki one:
https://godoc.org/github.com/natefinch/godocgo

let's go with that.