updated docs, fixes #1