Merge branch 'rel-4.0' into dev

docs/en/Migration-Guides/Abp-4_0.md

@@ -219,7 +219,38 @@ These properties implemented with `protected set` in the `Entity` and `Aggregate
 
 `IHasExtraProperties.ExtraProperties` was a regular `Dictionary<string, object>`. With the version 4.0, it is replaced with `ExtraPropertyDictionary` class which inherits the `Dictionary<string, object>`. 
 
-Most of the applications don't be affected by this change. If you've directly implemented this interface, replace the standard dictionary the the `ExtraPropertyDictionary`.
+Most of the applications don't be affected by this change. If you've directly implemented this interface, replace the standard dictionary to the `ExtraPropertyDictionary`.
+
+## Other Changes
+
+### IdentityOptions Usage
+
+Previously, when you inject `IOptions<IdentityOptions>`, you get a dynamically overridden options value. For example, when you get `IdentityOptions.Password.RequiredLength`, the value is being changed based on the setting (`IdentitySettingNames.Password.RequiredLength`) of the current tenant. That means `IdentityOptions` changes per tenant. However, this caused an [issue](https://github.com/abpframework/abp/issues/6318) and we [had to change](https://github.com/abpframework/abp/pull/6333) the usage.
+
+With the version 4.0, you need to inject `IOptions<IdentityOptions>` and call the new `SetAsync` method before using it, to be able to override the options by the settings. Otherwise, you get the default (statically configured) values of the options.
+
+Example usage:
+
+````csharp
+public class MyService : ITransientDependency
+{
+    private readonly IOptions<IdentityOptions> _options;
+
+    public MyService(IOptions<IdentityOptions> options)
+    {
+        _options = options;
+    }
+
+    public async Task DoItAsync()
+    {
+        await _options.SetAsync();
+        
+        var requiredLength = _options.Value.Password.RequiredLength;
+    }
+}
+````
+
+Pre-built modules already handles this. However, if you have used `IdentityOptions` directly in your code, you also need to follow this new pattern.
 
 ## ASP.NET Core MVC / Razor Pages UI