DOC: doc updates for external compatibility