docs - account for case when ordering endpoint links (#37588)

docs/api-documentation.md

@@ -24,13 +24,13 @@ Check out an introduction to the [Metabase API](https://www.metabase.com/learn/a
 _* indicates endpoints used for features available on [paid plans](https://www.metabase.com/pricing)._
 
 
-- [API key](api/api-key.md)
 - [Action](api/action.md)
 - [Activity](api/activity.md)
 - [Advanced config logs*](api/ee/advanced-config-logs.md)
 - [Advanced permissions application*](api/ee/advanced-permissions-application.md)
 - [Advanced permissions impersonation*](api/ee/advanced-permissions-impersonation.md)
 - [Alert](api/alert.md)
+- [API key](api/api-key.md)
 - [Audit app user*](api/ee/audit-app-user.md)
 - [Automagic dashboards](api/automagic-dashboards.md)
 - [Bookmark](api/bookmark.md)
@@ -59,8 +59,6 @@ _* indicates endpoints used for features available on [paid plans](https://www.m
 - [Public](api/public.md)
 - [Pulse](api/pulse.md)
 - [Revision](api/revision.md)
-- [SSO*](api/ee/sso.md)
-- [SSO SAML](api/sso-saml.md)
 - [Sandbox GTAP*](api/ee/sandbox-gtap.md)
 - [Sandbox table*](api/ee/sandbox-table.md)
 - [Sandbox user*](api/ee/sandbox-user.md)
@@ -70,6 +68,8 @@ _* indicates endpoints used for features available on [paid plans](https://www.m
 - [Setting](api/setting.md)
 - [Setup](api/setup.md)
 - [Slack](api/slack.md)
+- [SSO*](api/ee/sso.md)
+- [SSO SAML](api/sso-saml.md)
 - [Table](api/table.md)
 - [Task](api/task.md)
 - [Tiles](api/tiles.md)

docs/api/dashboard.md

@@ -26,6 +26,20 @@ Delete a Dashboard.
 
 *  **`id`** value must be an integer greater than zero.
 
+## `GET /api/dashboard/`
+
+This endpoint is currently unused by the Metabase frontend and may be out of date with the rest of the application.
+  It only exists for backwards compatibility and may be removed in the future.
+
+  Get `Dashboards`. With filter option `f` (default `all`), restrict results as follows:
+  *  `all`      - Return all Dashboards.
+  *  `mine`     - Return Dashboards created by the current user.
+  *  `archived` - Return Dashboards that have been archived. (By default, these are *excluded*.).
+
+### PARAMS:
+
+*  **`f`** nullable enum of all, mine, archived
+
 ## `GET /api/dashboard/:dashboard-id/dashcard/:dashcard-id/execute`
 
 Fetches the values for filling in execution parameters. Pass PK parameters and values to select.

src/metabase/cmd/endpoint_dox.clj

@@ -197,7 +197,9 @@
   (->> (collect-endpoints)
        (map process-endpoint)
        (group-by :ns-name)
-       (into (sorted-map))))
+       (into (sorted-map-by (fn [a b] (compare
+                                       (u/lower-case-en a)
+                                       (u/lower-case-en b)))))))
 
 ;;;; Page generators