updating the docs to be helpful next time