update to 28.4.0 (#648)

Bump the v28 docs to the 28.4.0 release:

- point the `28` version variables (`version`, `sourceVersion`, `dockerVersion`, `displayVersion`) at 28.4.0
- update the v28 entry in `update_api_docs.sh` to `28.4.0`
- regenerate `static/swagger-28.json` and `static/openapi3-28.json` from the `v28.4.0` tag, which marks `path` as required in `CreatePullReviewComment` (go-gitea/gitea#40260)

Reviewed-on: https://gitea.com/gitea/docs/pulls/648
Reviewed-by: TheFox0x7 <[email protected]>

packages/content-loader/src/products.ts

@@ -89,11 +89,11 @@ const variables: Record<string, VersionVariables> = {
     goVersion: '1.27',
     minGoVersion: '1.27',
     minNodeVersion: '22',
-    version: '28.3.0',
-    sourceVersion: 'v28.3.0',
+    version: '28.4.0',
+    sourceVersion: 'v28.4.0',
     sourceBranch: 'release/v28',
-    dockerVersion: '28.3.0',
-    displayVersion: '28.3.0',
+    dockerVersion: '28.4.0',
+    displayVersion: '28.4.0',
   },
   '1.27': {
     goVersion: '1.26',

static/openapi3-28.json

@@ -4596,6 +4596,9 @@
             "x-go-name": "Path"
           }
         },
+        "required": [
+          "path"
+        ],
         "type": "object",
         "x-go-package": "gitea.dev/modules/structs"
       },
@@ -11119,7 +11122,7 @@
       "url": "http://opensource.org/licenses/MIT"
     },
     "title": "Gitea API",
-    "version": "28.3.0"
+    "version": "28.4.0"
   },
   "openapi": "3.0.3",
   "paths": {

static/swagger-28.json

@@ -17,7 +17,7 @@
       "name": "MIT",
       "url": "http://opensource.org/licenses/MIT"
     },
-    "version": "28.3.0"
+    "version": "28.4.0"
   },
   "basePath": "https://gitea.com/api/v1",
   "paths": {
@@ -27644,6 +27644,9 @@
     "CreatePullReviewComment": {
       "description": "CreatePullReviewComment represent a review comment for creation api",
       "type": "object",
+      "required": [
+        "path"
+      ],
       "properties": {
         "body": {
           "type": "string",

update_api_docs.sh

@@ -127,7 +127,7 @@ if [ "$LATEST_ONLY" -eq 1 ]; then
   exit 0
 fi
 
-for ver in '28.3.0' '1.27.3' '1.26.4' '1.25.5' '1.24.7' '1.23.8' '1.22.6'; do
+for ver in '28.4.0' '1.27.3' '1.26.4' '1.25.5' '1.24.7' '1.23.8' '1.22.6'; do
   # 1.x releases are suffixed with the minor (1.27.3 -> 27), the versions
   # without the 1. prefix with the major (28.0.0 -> 28)
   case "$ver" in