diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6b758ae80..9f92e76e2 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -48,7 +48,12 @@ and this project adheres to
   match the contract address from `mock_env`. ([#2211])
 - cosmwasm-derive: Automatically detect whether the package is a dependency or
   the primary package, only expanding entrypoints for the primary package. This
-  effectively deprecates the usage of the `library` feature pattern. ([#2246])
+  effectively deprecates the usage of the `library` feature pattern.
+
+  Note: This feature does **NOT** interact well with workspaces due to a cargo
+  bug. If you have multiple contracts in a workspace, you might still want to
+  use the library feature ([#2246])
+
 - cosmwasm-std: Deprecate `BankQuery::AllBalances` and `IbcQuery::ListChannels`.
   Both are inherently problematic to use because the returned entries are
   unbounded. ([#2247])