From f50759278a86f38b3c1f89fbb803ac8b4e9aa694 Mon Sep 17 00:00:00 2001
From: mahabaleshwars <147705296+mahabaleshwars@users.noreply.github.com>
Date: Wed, 21 Oct 2026 21:36:55 +0530
Subject: [PATCH 1/4] docs: clarify description of go-bin-path output and its
 fallback behavior

---
 action.yml             | 4 ++--
 docs/advanced-usage.md | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/action.yml b/action.yml
index 79299e5..c762175 100644
--- a/action.yml
+++ b/action.yml
@@ -31,7 +31,7 @@ outputs:
   GOBIN:
     description: 'The value of `go env GOBIN`.'
   go-bin-path:
-    description: 'The base Go binary directory: `GOBIN`, otherwise `bin` under the first `GOPATH` entry.'
+    description: 'The base Go binary directory: the `GOBIN` value, otherwise `bin` under the first `GOPATH` entry when `GOBIN` is empty.'
   GOROOT:
     description: 'The value of `go env GOROOT`.'
   GOCACHE:
@@ -48,4 +48,4 @@ runs:
   using: 'node24'
   main: 'dist/setup/index.js'
   post: 'dist/cache-save/index.js'
-  post-if: success()
+  post-if: success()
\ No newline at end of file
diff --git a/docs/advanced-usage.md b/docs/advanced-usage.md
index 0e3efa5..64deda7 100644
--- a/docs/advanced-usage.md
+++ b/docs/advanced-usage.md
@@ -431,7 +431,7 @@ Once Go is on the `PATH`, the action exposes the most commonly needed `go env` v
 | --- | --- |
 | `GOPATH` | Go workspace root; `bin` and `pkg/mod` live under it |
 | `GOBIN` | Go 1.27+ reports an implicit `$GOPATH/bin` default; earlier releases are empty unless `GOBIN` is set |
-| `go-bin-path` | The base Go binary directory (`GOBIN` or `$GOPATH/bin`), using the first `GOPATH` entry. Cross-compiled binaries go one level deeper, in `$GOPATH/bin/$GOOS_$GOARCH` |
+| `go-bin-path` | Uses `GOBIN`, or falls back to `bin` under the first `GOPATH` entry when `GOBIN` is empty. It normally matches `GOBIN` on Go 1.27+; the fallback is a convenience for earlier releases. When `GOBIN` is not explicitly set (in the environment or via `go env -w`), cross-compiled binaries go one level deeper, in `$GOPATH/bin/${GOOS}_${GOARCH}` |
 | `GOROOT` | Installation directory of the Go toolchain in use |
 | `GOCACHE` | Build cache directory |
 | `GOMODCACHE` | Module cache directory |

From d41c13bdfa9b9d1dc30839fe0ed9aac130a3b227 Mon Sep 17 00:00:00 2001
From: mahabaleshwars <147705296+mahabaleshwars@users.noreply.github.com>
Date: Thu, 22 Oct 2026 19:32:50 +0530
Subject: [PATCH 2/4] fix: add newline at end of action.yml for proper
 formatting

---
 action.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/action.yml b/action.yml
index c762175..408e036 100644
--- a/action.yml
+++ b/action.yml
@@ -48,4 +48,5 @@ runs:
   using: 'node24'
   main: 'dist/setup/index.js'
   post: 'dist/cache-save/index.js'
-  post-if: success()
\ No newline at end of file
+  post-if: success()
+  
\ No newline at end of file

From 65cac96f552a6237fdfbf182ba50bc7b8a7ef54c Mon Sep 17 00:00:00 2001
From: mahabaleshwars <147705296+mahabaleshwars@users.noreply.github.com>
Date: Thu, 22 Oct 2026 19:36:21 +0530
Subject: [PATCH 3/4] fix: remove unnecessary newline in action.yml

---
 action.yml | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/action.yml b/action.yml
index 408e036..c762175 100644
--- a/action.yml
+++ b/action.yml
@@ -48,5 +48,4 @@ runs:
   using: 'node24'
   main: 'dist/setup/index.js'
   post: 'dist/cache-save/index.js'
-  post-if: success()
-  
\ No newline at end of file
+  post-if: success()
\ No newline at end of file

From 6e26eb738d8d4c4964775040c01045ad665f3c79 Mon Sep 17 00:00:00 2001
From: mahabaleshwars <147705296+mahabaleshwars@users.noreply.github.com>
Date: Thu, 22 Oct 2026 19:51:30 +0530
Subject: [PATCH 4/4] fix: add missing newline at end of action.yml

---
 action.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/action.yml b/action.yml
index c762175..6ca1442 100644
--- a/action.yml
+++ b/action.yml
@@ -48,4 +48,4 @@ runs:
   using: 'node24'
   main: 'dist/setup/index.js'
   post: 'dist/cache-save/index.js'
-  post-if: success()
\ No newline at end of file
+  post-if: success()