DOC: updated documentation to reflect change added in #717