making some last edits to docs in preparation for readthedocs and sphinx migration