add note about API breakage
DOC: difference upper lower case