overhauling the docs for release