Update the runner reference pages (#597)

Automated update of the generated runner reference pages from gitea/runner (main for the develop docs, the newest stable tag for every documented series), opened by the "update runner reference" scheduled workflow.

<!-- cloudflare-preview --> Preview: https://pr-597.docs-gitea-com.pages.dev

---------

Co-authored-by: Lunny Xiao <[email protected]>
Reviewed-on: https://gitea.com/gitea/docs/pulls/597
Reviewed-by: Lunny Xiao <[email protected]>
Co-authored-by: Gitea Bot <[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.1.0',
-    sourceVersion: 'v28.1.0',
+    version: '28.2.0',
+    sourceVersion: 'v28.2.0',
     sourceBranch: 'release/v28',
-    dockerVersion: '28.1.0',
-    displayVersion: '28.1.0',
+    dockerVersion: '28.2.0',
+    displayVersion: '28.2.0',
   },
   '1.27': {
     goVersion: '1.26',

runner-docs/reference/config-example.md

@@ -76,9 +76,9 @@ runner:
   #workdir_cleanup_age: 24h
   # Cadence for the idle cleanup pass. Besides the directories above, on runners that use
   # docker it removes the per-job networks and volumes of jobs this runner did not live to
-  # tear down, which would otherwise hold a subnet of the daemon address pool and the job's
-  # workspace contents until the host is rebuilt. On runners with kubernetes labels it
-  # removes such jobs' pods and Secrets.
+  # tear down once unused and 10 minutes old, which would otherwise hold a subnet of the
+  # daemon address pool and the job's workspace contents until the host is rebuilt. On
+  # runners with kubernetes labels it removes such jobs' pods and Secrets.
   #idle_cleanup_interval: 10m
   # The base interval for periodic log flush to the Gitea instance.
   # Logs may be sent earlier if the buffer reaches log_report_batch_size
@@ -91,6 +91,9 @@ runner:
   # Flush logs immediately when the buffer reaches this many rows.
   # This ensures bursty output (e.g., npm install) is delivered promptly.
   #log_report_batch_size: 100
+  # The lowest severity of the runner's own messages (not step output) that are sent to the
+  # job log between steps: trace, debug, info, warn, error. Default if omitted: follow log.level.
+  #log_report_level: info
   # The interval for reporting task state (step status, timing) to the Gitea instance.
   # State is also reported on step transitions (start/stop) and after each log flush.
   #state_report_interval: 5s
@@ -103,11 +106,12 @@ runner:
   # it replaces https://github.com with the value here, which is useful for some special network environments.
   #github_mirror: ''
   # Extra HTTP headers for runner API requests to Gitea, e.g. reverse proxy authentication.
-  # Not used for action clones, artifacts, job summaries or jobs. Runner headers take precedence.
+  # Not used for action downloads, artifacts, job summaries or jobs. Runner headers take precedence.
   # Dropped on redirects to another hostname, or to HTTP if the instance URL uses HTTPS.
   #extra_headers:
   #  X-Proxy-Token: 'example'
-  # When true (the default), fetch only the requested ref of an action repository (e.g. actions/checkout@v4) at depth 1 instead of cloning every branch's full history.
+  # When true (the default), clone only the requested ref at depth 1 instead of every branch's full history. Actions download as
+  # archives, so this applies to reusable workflows and to actions whose host serves no archive of them.
   # Set to false to clone the full history.
   #action_shallow_clone: true
   # When true (the default), inject the ACT=true environment variable into jobs.

static/openapi3-28.json

@@ -11119,7 +11119,7 @@
       "url": "http://opensource.org/licenses/MIT"
     },
     "title": "Gitea API",
-    "version": "28.1.0"
+    "version": "28.2.0"
   },
   "openapi": "3.0.3",
   "paths": {
@@ -37709,4 +37709,4 @@
       "name": "user"
     }
   ]
-}
+}

static/swagger-28.json

@@ -17,7 +17,7 @@
       "name": "MIT",
       "url": "http://opensource.org/licenses/MIT"
     },
-    "version": "28.1.0"
+    "version": "28.2.0"
   },
   "basePath": "https://gitea.com/api/v1",
   "paths": {
@@ -35341,4 +35341,4 @@
       "name": "user"
     }
   ]
-}
+}

update_api_docs.sh

@@ -127,7 +127,7 @@ if [ "$LATEST_ONLY" -eq 1 ]; then
   exit 0
 fi
 
-for ver in '28.1.0' '1.27.3' '1.26.4' '1.25.5' '1.24.7' '1.23.8' '1.22.6'; do
+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
   # 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