update docs to recent changes