We have this documented on https://www.mediawiki.org/wiki/API:Compare (for example), but we don't document this in any form on https://www.mediawiki.org/w/api.php?action=help&modules=compare
Would've made digging the history for T342630: ext.translate.special.pagepreparation.js makes a MW API query that results in a deprecated warning a little easier :)