update docs

Update docs after testers feedback.