The problem is that autodoc can list functions in source-file order, or it can list them alphabetically which I thought was even worse. So unless we're gonna manually import each function one-by-one in the docs (which wouldn't be maintainable as functions are added and remove) this would have to be done by reordering the functions in the source file. But I agree they should be better-ordered in the source file.

Part of the problem is that in the source the functions are sorted into get, update, create and delete modules. This means it's not possible for autodoc to show e.g. all the functions for getting, creating updating or deleting packages on one docs page or section, those for organizations on another, etc. Autodoc just pulls them out according to how they are in the source files. So arguably we should rearrange all the source files into topics.