From bf8f4ce394ba0f6cd2b7720242a87cb31be6b53e Mon Sep 17 00:00:00 2001
From: bircni <bircni@icloud.com>
Date: Sun, 15 Nov 2026 21:03:40 +0000
Subject: [PATCH] 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 <95654+thefox0x7@noreply.gitea.com>
---
 packages/content-loader/src/products.ts | 8 ++++----
 static/openapi3-28.json                 | 5 ++++-
 static/swagger-28.json                  | 5 ++++-
 update_api_docs.sh                      | 2 +-
 4 files changed, 13 insertions(+), 7 deletions(-)

diff --git a/packages/content-loader/src/products.ts b/packages/content-loader/src/products.ts
index 58fe7f1e..427c1819 100644
--- a/packages/content-loader/src/products.ts
+++ b/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',
diff --git a/static/openapi3-28.json b/static/openapi3-28.json
index 42626330..f1b3d7c4 100644
--- a/static/openapi3-28.json
+++ b/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": {
diff --git a/static/swagger-28.json b/static/swagger-28.json
index 55dd0d37..7a4d17fd 100644
--- a/static/swagger-28.json
+++ b/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",
diff --git a/update_api_docs.sh b/update_api_docs.sh
index 21a11d3c..b9190049 100755
--- a/update_api_docs.sh
+++ b/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