As noted above: please do not conflate too many things into one pull request. These changes require proper discussion and should not be mixed into a pull request that should only bring the README up to date on the API removal.