diff --git a/src/docs/releases/1.9.0.md b/src/docs/releases/1.9.0.md
index 2e3a712de80..1c6f3c09447 100644
--- a/src/docs/releases/1.9.0.md
+++ b/src/docs/releases/1.9.0.md
@@ -8,7 +8,7 @@ Release date: Not yet released
 
 The utilization of [Newtonsoft.Json](https://www.nuget.org/packages/Newtonsoft.Json) `has been discontinued in both **YesSql** and **OrchardCore**. Instead, we have transitioned to utilize `System.Text.Json` due to its enhanced performance capabilities. To ensure compatibility with `System.Text.Json` during the serialization or deserialization of objects, the following steps need to be undertaken:
 
- - If your custom Document includes a collection with a getter-only property, it is imperative to incorporate a setter or utilize the `init` modifier to facilitate the assignment of values by `System.Text.Json`. For instance:
+ - If your custom `Document` includes a collection with a getter-only property, it is imperative to incorporate a setter or utilize the `init` modifier to facilitate the assignment of values by `System.Text.Json`. For instance:
 
 ```csharp
 public class MediaProfilesDocument : Document
@@ -40,17 +40,25 @@ change it to the following
 services.AddDeployment<AdminMenuDeploymentSource, AdminMenuDeploymentStep, AdminMenuDeploymentStepDriver>();
 ```
 
+  - Any serializable object that contains a polymorphic property (a base type that can contain sub-classes instances) needs to register all possible sub-classes this way:
+
+```csharp
+services.AddJsonDerivedTypeInfo<UrlCondition, Condition>();
+```
+
+In particular any type introduced in custom modules inheriting from `MenuItem`, `AdminNode`, `Condition`, `ConditionOperator`, `Query`, `SitemapType` will have to use this method.
+
 ### Media Indexing
 
-Previously, `.PDF` file where auto indexed in the search providers (Elasticsearch, Lucene or Azure AI Search). Now, if you want to continue to index `.PDF` file you'll need to enable `OrchardCore.Media.Indexing.Pdf` feature.
+Previously, `.pdf` files were automatically indexed in the search providers (Elasticsearch, Lucene or Azure AI Search). Now, if you want to continue to index `.PDF` file you'll need to enable `OrchardCore.Media.Indexing.Pdf` feature.
 
-Additionally, if you needed to enable indexing for text file with `.txt`, `.md` extensions, you'll needed `OrchardCore.Media.Indexing.Text` feature.
+Additionally, if you need to enable indexing for text file with `.txt`, `.md` extensions, you'll needed `OrchardCore.Media.Indexing.Text` feature.
 
-If you needed to enable indexing for other extensions like (`.docx`, or `.pptx`), you'll needed `OrchardCore.Media.Indexing.OpenXML` feature.
+If you need to enable indexing for other extensions like (`.docx`, or `.pptx`), you'll need `OrchardCore.Media.Indexing.OpenXML` feature.
 
 ### SMS Module
 
-In the past, we utilized the injection of `ISmsProvider`for sending SMS messages. However, in this release, it is now necessary to inject `ISmsService` instead.
+In the past, we utilized the injection of `ISmsProvider` for sending SMS messages. However, in this release, it is now necessary to inject `ISmsService` instead.
 
 Additionally, `Twilio` provider is no longer enabled by default. If you want to use Twilio SMS provider, you must enable `OrchardCore.Sms.Twilio` feature.