Sort API pages

mtojek · mtojek · commit 1ebf40884815 · 2023-01-11T14:21:05.000+01:00
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -326,16 +326,8 @@
       "icon_path": "./images/icons/api.svg",
       "children": [
         {
-          "title": "Authentication",
-          "path": "./api/authentication.md"
-        },
-        {
-          "title": "General",
-          "path": "./api/general.md"
-        },
-        {
-          "title": "Enterprise",
-          "path": "./api/enterprise.md"
+          "title": "Agents",
+          "path": "./api/agents.md"
         },
         {
           "title": "Applications",
@@ -345,49 +337,57 @@
           "title": "Audit",
           "path": "./api/audit.md"
         },
+        {
+          "title": "Authentication",
+          "path": "./api/authentication.md"
+        },
         {
           "title": "Authorization",
           "path": "./api/authorization.md"
         },
         {
-          "title": "Files",
-          "path": "./api/files.md"
+          "title": "Builds",
+          "path": "./api/builds.md"
         },
         {
-          "title": "Organizations",
-          "path": "./api/organizations.md"
+          "title": "Enterprise",
+          "path": "./api/enterprise.md"
         },
         {
-          "title": "Templates",
-          "path": "./api/templates.md"
+          "title": "Files",
+          "path": "./api/files.md"
+        },
+        {
+          "title": "General",
+          "path": "./api/general.md"
         },
         {
           "title": "Members",
           "path": "./api/members.md"
         },
         {
-          "title": "Workspaces",
-          "path": "./api/workspaces.md"
+          "title": "Organizations",
+          "path": "./api/organizations.md"
         },
         {
           "title": "Parameters",
           "path": "./api/parameters.md"
         },
         {
-          "title": "Users",
-          "path": "./api/users.md"
+          "title": "Schemas",
+          "path": "./api/schemas.md"
         },
         {
-          "title": "Builds",
-          "path": "./api/builds.md"
+          "title": "Templates",
+          "path": "./api/templates.md"
         },
         {
-          "title": "Agents",
-          "path": "./api/agents.md"
+          "title": "Users",
+          "path": "./api/users.md"
         },
         {
-          "title": "Schemas",
-          "path": "./api/schemas.md"
+          "title": "Workspaces",
+          "path": "./api/workspaces.md"
         }
       ]
     }
diff --git a/scripts/apidocgen/postprocess/main.go b/scripts/apidocgen/postprocess/main.go
@@ -9,6 +9,7 @@ import (
 	"os"
 	"path"
 	"regexp"
+	"sort"
 	"strings"
 
 	"golang.org/x/xerrors"
@@ -132,6 +133,11 @@ func writeDocs(sections [][]byte) error {
 		})
 	}
 
+	// Sort API pages
+	sort.Slice(mdFiles, func(i, j int) bool {
+		return sort.StringsAreSorted([]string{mdFiles[i].title, mdFiles[j].title})
+	})
+
 	// Update manifest.json
 	type route struct {
 		Title       string  `json:"title,omitempty"`
