DOC clarification of api change