Merge pull request #210 from Arkatufus/Update_RELEASE_NOTES.md_for_1.…

…10.0_release Update RELEASE_NOTES.md for 0.10.0 release
akkadotnet · Apr 13, 2021 · e620a15 · e620a15
2 parents 37209fe + 8ec06db
commit e620a15
Showing 1 changed file with 22 additions and 10 deletions.
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -1,10 +1,22 @@
-### 0.9.17 March 25 2021 ####
-* [Bump Microsoft.NET.Test.Sdk from 16.6.1 to 16.7.1](https://github.com/akkadotnet/Hyperion/pull/182)
-* [Fix unit test problem](https://github.com/akkadotnet/Hyperion/pull/191)
-* [Bump FSharp.Core from 4.7.2 to 5.0.0](https://github.com/akkadotnet/Hyperion/pull/189)
-* [Fix issue #40 regarding partial streams](https://github.com/akkadotnet/Hyperion/pull/185)
-* [Fix Hyperion not using known serializers when defined](https://github.com/akkadotnet/Hyperion/pull/184)
-* [Bump Microsoft.NET.Test.Sdk from 16.7.1 to 16.8.3](https://github.com/akkadotnet/Hyperion/pull/196)
-* [Bump System.Collections.Immutable from 1.7.1 to 5.0.0](https://github.com/akkadotnet/Hyperion/pull/195)
-* [Bump FSharp.Core from 5.0.0 to 5.0.1](https://github.com/akkadotnet/Hyperion/pull/202)
-* [Update the cross framework spec to include complex POCO object, Type serialization, and support for netcoreapp3.1 and net5.0](https://github.com/akkadotnet/Hyperion/pull/204)
+### 0.10.0 April 13 2021 ####
+* [Add a generic cross platform serialization support](https://github.com/akkadotnet/Hyperion/pull/208)
+
+# Cross platform serialization
+
+You can now address any cross platform package serialization differences by providing a list of package name transformation lambda function into the `SerializerOptions` constructor. The package name will be passed into the lambda function before it is deserialized, and the result of the string transformation is used for deserialization instead of the original package name.
+
+This short example shows how to address the change from `System.Drawing` in .NET Framework to `System.Drawing.Primitives` in .NET Core:
+
+```
+Serializer serializer;
+#if NETFX
+serializer = new Serializer(new SerializerOptions(
+    packageNameOverrides: new List<Func<string, string>> {
+        str => str.Contains("System.Drawing.Primitives") ? str.Replace(".Primitives", "") : str
+    }));
+#elif NETCOREAPP
+serializer = new Serializer();
+#endif
+```
+
+Note that only one package name transformation is allowed, any transform lambda function after the first applied transformation is ignored.