diff --git a/Readme.md b/Readme.md
index 547ac7d..ad744b0 100644
--- a/Readme.md
+++ b/Readme.md
@@ -450,3 +450,25 @@ var variant1 = new Parent1.Parent2.Nested.Variant1();
- [Web Client](./samples/PokemonClient/PokeClient.cs)
- [Recursive Expressions](./samples/ExpressionCalculator/Program.cs)
- [Recursive Expressions with Stateful Matching](./samples/ExpressionCalculatorWithState/Program.cs)
+
+## Migration
+
+### Migrating from versions < 1.11.0 to versions >= 1.11.0
+
+From v1.11.0 this library now contains an assembly reference.
+
+By default before this `dotnet add package dunet` will have generated:
+```xml
+
+ runtime; build; native; contentfiles; analyzers; buildtransitive
+ all
+
+```
+
+When upgrading to dunet v1.11.0, this will need to be simplified to:
+```xml
+
+```
+
+Otherwise the assembly will not be included for compilation, leading to build failures when trying to reference
+ the `Dunet` namespace or the `UnionAttribute` class.
\ No newline at end of file