Sorting order should go: 1. Public APIs 2. Developer APIs And within each, APIs should be sorted alphabetically. I think this will be easier for readers to navigate, especially since the current reference isn't meaningfully sorted.