From 5a58be1c0450f33476a138c5181f256cb44a1773 Mon Sep 17 00:00:00 2001
From: Trask Stalnaker <trask.stalnaker@gmail.com>
Date: Tue, 24 Dec 2024 10:32:02 -0800
Subject: [PATCH] Migration notes for next release

---
 CHANGELOG.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a1e78aab966a..22a2f83a6c7d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+### Migration notes
+
+In preparation for stabilizing HTTP library instrumentation soon:
+
+- `setCaptured*Headers(List)` methods in `*TelemetryBuilder` classes were changed to
+  `setCaptured*Headers(Collection)`       
+  ([#12901](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/12901))
+- `setKnownMethods(Set)` methods in `*TelemetryBuilder` classes were changed to
+  `setKnownMethods(Collection)`
+  ([#12902](https://github.com/open-telemetry/opentelemetry-java-instrumentation/pull/12902))
+
 ## Version 2.11.0 (2024-12-23)
 
 ### Migration notes