docs to close #993