update docs and modes