update docs; add do-nothing example
Merge pull request #21 from rogpeppe/022-update-docs

update docs