refactor docs & update copy