From 1fd2395cd3d1a6750439434028a7bf44a5641821 Mon Sep 17 00:00:00 2001 From: majiayu000 <1835304752@qq.com> Date: Fri, 26 Dec 2025 14:34:05 +0800 Subject: [PATCH] docs: fix reversed descriptions of version.Arch and info.Architecture The API documentation had incorrect descriptions for these fields: - `/version` endpoint's `Arch` field was described generically but actually returns the Go runtime's GOARCH value - `/info` endpoint's `Architecture` field incorrectly stated it returns GOARCH, but it actually returns the OS-reported hardware architecture (equivalent to `uname -m`) This commit corrects the descriptions to accurately reflect the implementation. Fixes #49594 Signed-off-by: majiayu000 <1835304752@qq.com> --- api/swagger.yaml | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/api/swagger.yaml b/api/swagger.yaml index 610dc778d8..fd53b259b6 100644 --- a/api/swagger.yaml +++ b/api/swagger.yaml @@ -6587,7 +6587,9 @@ definitions: example: "linux" Arch: description: | - The architecture that the daemon is running on + Architecture of the daemon, as returned by the Go runtime (`GOARCH`). + + A full list of possible values can be found in the [Go documentation](https://go.dev/doc/install/source#environment). type: "string" example: "amd64" KernelVersion: @@ -6814,10 +6816,13 @@ definitions: example: "linux" Architecture: description: | - Hardware architecture of the host, as returned by the Go runtime - (`GOARCH`). + Hardware architecture of the host, as returned by the operating system. + This is equivalent to the output of `uname -m` on Linux. - A full list of possible values can be found in the [Go documentation](https://go.dev/doc/install/source#environment). + Unlike `Arch` (from `/version`), this reports the machine's native + architecture, which can differ from the Go runtime architecture when + running a binary compiled for a different architecture (for example, + a 32-bit binary running on 64-bit hardware). type: "string" example: "x86_64" NCPU: