DOC: more inline documentation