improved docs (fixes #39)