update docs after review