Follow-up from "Package api sorting" - Docs

The following discussion from !20963 (merged) should be addressed:

Create docs for the sorting feature.