patching up some docs for release