update docs, resolves #1