update docs for easy cut n paste