Merge branch 'main' into 3522-validation

mtojek · mtojek · commit 08f1f26b1e5f · 2023-01-11T16:50:44.000+01:00
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -325,6 +325,10 @@
       "path": "./api/index.md",
       "icon_path": "./images/icons/api.svg",
       "children": [
+        {
+          "title": "General",
+          "path": "./api/general.md"
+        },
         {
           "title": "Agents",
           "path": "./api/agents.md"
@@ -357,10 +361,6 @@
           "title": "Files",
           "path": "./api/files.md"
         },
-        {
-          "title": "General",
-          "path": "./api/general.md"
-        },
         {
           "title": "Members",
           "path": "./api/members.md"
diff --git a/scripts/apidocgen/postprocess/main.go b/scripts/apidocgen/postprocess/main.go
@@ -134,7 +134,14 @@ func writeDocs(sections [][]byte) error {
 	}
 
 	// Sort API pages
+	// The "General" section is expected to be always first.
 	sort.Slice(mdFiles, func(i, j int) bool {
+		if mdFiles[i].title == "General" {
+			return true // "General" < ... - sorted
+		}
+		if mdFiles[j].title == "General" {
+			return false // ... < "General" - not sorted
+		}
 		return sort.StringsAreSorted([]string{mdFiles[i].title, mdFiles[j].title})
 	})
 
