all: add some doc comments
Merge pull request #31 from rogpeppe/033-better-docs

all: add some doc comments