update docs and other user-facing stuff