flush out docs (fixes #8)