update docs with corrections