update docs and fix description