updating docs to match these minor cleanups