Investigate the nuances of how current content ordering is determined

[sean1588]

We intent to reorganize the ordering of docs content on the api docs pages, see #3925 for more information. This could imply changes that need to be made in the codegen process as well as the templates we use to render as well as changes in the registry repo. The goal is to figure out what needs to be done here to inform the rest of the tasks that are part of this issue.