From 1ddf2d83e38a1f17784e69fc0860dc3bc460d333 Mon Sep 17 00:00:00 2001
From: Paul Meyer <49727155+katexochen@users.noreply.github.com>
Date: Fri, 18 Oct 2024 10:21:50 +0200
Subject: [PATCH] docs/release-notes: document deprecations in Go ecosystem

Signed-off-by: Paul Meyer <49727155+katexochen@users.noreply.github.com>
---
 nixos/doc/manual/release-notes/rl-2411.section.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/nixos/doc/manual/release-notes/rl-2411.section.md b/nixos/doc/manual/release-notes/rl-2411.section.md
index 39bd3065d63d..a57633fae2d1 100644
--- a/nixos/doc/manual/release-notes/rl-2411.section.md
+++ b/nixos/doc/manual/release-notes/rl-2411.section.md
@@ -627,6 +627,12 @@
   `goModules`, `modRoot`, `vendorHash`, `deleteVendor`, and `proxyVendor` are now passed as derivation attributes.
   `goModules` and `vendorHash` are no longer placed under `passthru`.
 
+- `buildFlags`/`buildFlagsArray` on `buildGoModule` have been deprecated. 24.11 is the last release where `buildGoModule` accepts these flags (while throwing a warning).
+  Use the [`ldflags`](https://nixos.org/manual/nixpkgs/unstable/#var-go-ldflags) and/or [`tags`](https://nixos.org/manual/nixpkgs/unstable/#var-go-tags) attributes or
+  [the environment](https://nixos.org/manual/nixpkgs/unstable/#ssec-go-environment) instead.
+
+- `buildGoPackage` has been deprecated. 24.11 is the last release with `buildGoPackage` available.
+
 - `hareHook` has been added as the language framework for Hare. From now on, it,
   not the `hare` package, should be added to `nativeBuildInputs` when building
   Hare programs.