diff --git a/ci/release_notes.md b/ci/release_notes.md
new file mode 100644
index 0000000..fa4fa56
--- /dev/null
+++ b/ci/release_notes.md
@@ -0,0 +1,3 @@
+### Improvements
+
+- Document why Alpine image can't be used for building to Go code
diff --git a/ci/settings.yml b/ci/settings.yml
index 5662ec9..9fb14bf 100644
--- a/ci/settings.yml
+++ b/ci/settings.yml
@@ -309,6 +309,20 @@ resources:
     source:
       repository:        golang
       semver_constraint: "< 1970" # Avoid YYYYMMDD tags like '20231219'
+      # NOTICE:
+      #
+      # TL;DR: No Alpine for building Golang code with CGO_ENABLED=1
+      #
+      # We can't use 'variant: alpine' here, because the 'go test -race' we
+      # use in Makefile requires CGO_ENABLED=1, which requires a C compiler,
+      # and a libc that implements the non-POSIX pread64() and pwrite64()
+      # functions. Only GNU libc ships with these. The musl libc from Alpine
+      # doesn't.
+      #
+      # The only solution is to revert back using a Debian image with proper
+      # GCC and GNU libc.
+      #
+      # See also: <https://stackoverflow.com/a/78096319/12178803>
 
   - name: alpine-latest
     type: registry-image