With the implementation of max-heaps, the docs should be revised with examples and descriptions for both. The docs should also be made more formal (https://github.com/python/cpython/issues/62480) I will be working on this. <!-- gh-linked-prs --> ### Linked PRs * gh-133531 * gh-133591 * gh-133613 * gh-133937 <!-- /gh-linked-prs -->