This commit DRYs up the indices folder as well as fixing a few minor mishaps that were in the docs.
* REST high-level client: add clear cache API Relates to #27205 Also Closes #26947 (rest-spec were outdated)