From ba4abd749db7d1a5c79e8497bfc42fbb7126349a Mon Sep 17 00:00:00 2001
From: bircni <bircni@icloud.com>
Date: Sun, 1 Nov 2026 10:11:04 +0000
Subject: [PATCH] update to 28.3.0 (#623)

Bump the v28 docs to the 28.3.0 release:

- point the `28` version variables (`version`, `sourceVersion`, `dockerVersion`, `displayVersion`) at 28.3.0
- update the v28 entry in `update_api_docs.sh` to `28.3.0`
- regenerate `static/swagger-28.json` and `static/openapi3-28.json` from the `v28.3.0` tag, which picks up the updated `Deadline` and `Labels` descriptions from go-gitea/gitea#39869 and go-gitea/gitea#39873

Reviewed-on: https://gitea.com/gitea/docs/pulls/623
Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
---
 packages/content-loader/src/products.ts | 8 ++++----
 static/openapi3-28.json                 | 6 +++---
 static/swagger-28.json                  | 6 +++---
 update_api_docs.sh                      | 2 +-
 4 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/packages/content-loader/src/products.ts b/packages/content-loader/src/products.ts
index 725d8f8b..58fe7f1e 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.2.0',
-    sourceVersion: 'v28.2.0',
+    version: '28.3.0',
+    sourceVersion: 'v28.3.0',
     sourceBranch: 'release/v28',
-    dockerVersion: '28.2.0',
-    displayVersion: '28.2.0',
+    dockerVersion: '28.3.0',
+    displayVersion: '28.3.0',
   },
   '1.27': {
     goVersion: '1.26',
diff --git a/static/openapi3-28.json b/static/openapi3-28.json
index dc5c2963..42626330 100644
--- a/static/openapi3-28.json
+++ b/static/openapi3-28.json
@@ -5686,7 +5686,7 @@
             "x-go-name": "Description"
           },
           "due_on": {
-            "description": "Deadline is the updated due date for the milestone",
+            "description": "Deadline is the due date for the milestone, use null or empty string to remove the deadline",
             "format": "date-time",
             "type": "string",
             "x-go-name": "Deadline"
@@ -7416,7 +7416,7 @@
         "description": "IssueLabelsOption a collection of labels",
         "properties": {
           "labels": {
-            "description": "Labels can be a list of integers representing label IDs\nor a list of strings representing label names",
+            "description": "Labels can be a list of integers representing label IDs\nor a list of strings representing label names.\nIf a repository label and an organization label share a name,\nthe repository label is used.",
             "items": {},
             "type": "array",
             "x-go-name": "Labels"
@@ -11119,7 +11119,7 @@
       "url": "http://opensource.org/licenses/MIT"
     },
     "title": "Gitea API",
-    "version": "28.2.0"
+    "version": "28.3.0"
   },
   "openapi": "3.0.3",
   "paths": {
diff --git a/static/swagger-28.json b/static/swagger-28.json
index 753cb271..55dd0d37 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.2.0"
+    "version": "28.3.0"
   },
   "basePath": "https://gitea.com/api/v1",
   "paths": {
@@ -28779,7 +28779,7 @@
           "x-go-name": "Description"
         },
         "due_on": {
-          "description": "Deadline is the updated due date for the milestone",
+          "description": "Deadline is the due date for the milestone, use null or empty string to remove the deadline",
           "type": "string",
           "format": "date-time",
           "x-go-name": "Deadline"
@@ -30525,7 +30525,7 @@
       "type": "object",
       "properties": {
         "labels": {
-          "description": "Labels can be a list of integers representing label IDs\nor a list of strings representing label names",
+          "description": "Labels can be a list of integers representing label IDs\nor a list of strings representing label names.\nIf a repository label and an organization label share a name,\nthe repository label is used.",
           "type": "array",
           "items": {},
           "x-go-name": "Labels"
diff --git a/update_api_docs.sh b/update_api_docs.sh
index d01aea9f..21a11d3c 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.2.0' '1.27.3' '1.26.4' '1.25.5' '1.24.7' '1.23.8' '1.22.6'; do
+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
   # 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