doc tweaks suggested by golint