update docs, completes #3