I'm okay with the additional detail, but the javadocs don't seem to provide an alternative of how the users is supposed to be able to do this sort of operation. Do you know what the replacement is that we could refer to?

The JavaDoc's deprecated comments do say to use listCollections(). GitHub decided that is not worth showing :/ Is there something else we should be doing?

Ah, so it does my mistake. LGTM.

Actually, can we change the deprecation javadocs to use this format:

   * @deprecated Use {@link #listCollections()}.

Instead of the back-ticks. This will make the link clickable in the javadocs if we do it.

Updated the JavaDoc to use the links as suggested.

Codecov Report

Merging #5916 into master will decrease coverage by <.01%.
The diff coverage is n/a.

@@             Coverage Diff              @@
##             master    #5916      +/-   ##
============================================
- Coverage     46.79%   46.79%   -0.01%     
- Complexity    25648    25663      +15     
============================================
  Files          2456     2456              
  Lines        267593   267593              
  Branches      30564    30559       -5     
============================================
- Hits         125229   125228       -1     
- Misses       133105   133106       +1     
  Partials       9259     9259

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update b212217...26f2be6. Read the comment docs.