update docs and fix sentences