Sort index pages by name in docs (#560)

## Changes
The indices under the APIs and Dataclasses pages were not sorted,
resulting in them being shown in an unexpected/random order. This fixes
this so they are shown alphabetically.

## Tests
<!-- 
How is this tested? Please see the checklist below and also describe any
other relevant tests
-->

- [ ] `make test` run locally
- [ ] `make fmt` applied
- [ ] relevant integration tests applied

docs/account/index.rst

@@ -7,9 +7,9 @@ These APIs are available from AccountClient
 .. toctree::
    :maxdepth: 1
 
-   iam/index
+   billing/index
    catalog/index
-   settings/index
+   iam/index
+   oauth2/index
    provisioning/index
-   billing/index
-   oauth2/index
+   settings/index

docs/dbdataclasses/index.rst

@@ -5,20 +5,20 @@ Dataclasses
 .. toctree::
    :maxdepth: 1
 
-   workspace
+   billing
+   catalog
    compute
-   jobs
-   pipelines
+   dashboards
    files
+   iam
+   jobs
    ml
+   oauth2
+   pipelines
+   provisioning
    serving
-   iam
-   sql
-   catalog
-   sharing
    settings
-   provisioning
-   billing
-   oauth2
+   sharing
+   sql
    vectorsearch
-   dashboards
+   workspace

docs/gen-client-docs.py

@@ -330,7 +330,7 @@ def write_dataclass_docs(self):
             doc = DataclassesDoc(package=pkg, dataclasses=sorted(all_members))
             with open(f'{__dir__}/dbdataclasses/{pkg.name}.rst', 'w') as f:
                 f.write(doc.as_rst())
-        all = "\n   ".join([f'{p.name}' for p in self.packages])
+        all = "\n   ".join(sorted([p.name for p in self.packages]))
         with open(f'{__dir__}/dbdataclasses/index.rst', 'w') as f:
             f.write(f'''
 Dataclasses
@@ -374,7 +374,7 @@ def _write_client_packages(self, folder: str, label: str, description: str, pack
         """Writes out the top-level index for the APIs supported by a client."""
         self._make_folder_if_not_exists(f'{__dir__}/{folder}')
         with open(f'{__dir__}/{folder}/index.rst', 'w') as f:
-            all = "\n   ".join([f'{name}/index' for name in packages])
+            all = "\n   ".join([f'{name}/index' for name in sorted(packages)])
             f.write(f'''
 {label}
 {'=' * len(label)}
@@ -390,7 +390,7 @@ def _write_client_package_doc(self, folder: str, pkg: Package, services: list[st
         """Writes out the index for a single package supported by a client."""
         self._make_folder_if_not_exists(f'{__dir__}/{folder}/{pkg.name}')
         with open(f'{__dir__}/{folder}/{pkg.name}/index.rst', 'w') as f:
-            all = "\n   ".join(services)
+            all = "\n   ".join(sorted(services))
             f.write(f'''
 {pkg.label}
 {'=' * len(pkg.label)}

docs/workspace/index.rst

@@ -7,17 +7,17 @@ These APIs are available from WorkspaceClient
 .. toctree::
    :maxdepth: 1
 
-   workspace/index
+   catalog/index
    compute/index
-   jobs/index
-   pipelines/index
+   dashboards/index
    files/index
+   iam/index
+   jobs/index
    ml/index
+   pipelines/index
    serving/index
-   iam/index
-   sql/index
-   catalog/index
-   sharing/index
    settings/index
+   sharing/index
+   sql/index
    vectorsearch/index
-   dashboards/index
+   workspace/index