From 2905ec3c2a123abaad3bd55163907ffb0977fbed Mon Sep 17 00:00:00 2001
From: enisn <info@enisnecipoglu.com>
Date: Tue, 20 Apr 2021 13:53:20 +0300
Subject: [PATCH] Docs - Update State Provider section of Authorization.md

---
 docs/en/Authorization.md | 64 ++++++++++++++++++++++++++++++----------
 1 file changed, 48 insertions(+), 16 deletions(-)

diff --git a/docs/en/Authorization.md b/docs/en/Authorization.md
index d6cb8cee3f..22a88ce8cc 100644
--- a/docs/en/Authorization.md
+++ b/docs/en/Authorization.md
@@ -238,22 +238,54 @@ When you write this code inside your permission definition provider, it finds th
 
 ### Permission depending on a Condition
 
-Permission states can be managed according to a condition such as a Feature, Global Feature, or a custom condition. Any condition which implements `IPermissionStateProvider` can be added via calling `AddStateProvider()` method for **PermissionDefinition**.
-
-See an example below:
-
-```csharp
-myGroup.AddPermission("Author_Management")
-    // To depend on Global Feature
-    .AddStateProviders(new RequireGlobalFeaturesPermissionStateProvider("AuthorManagementFeature"));
-	// To depend on Feature
-    .AddStateProviders(new RequireFeaturesPermissionStateProvider("BookStore.AuthorManagement"));
-	// To depend on your custom implementation
-    .AddStateProviders(new MyCustomPermissionStateProvider());
-	
-```
-
-If condition is not met, permission won't be displayed and all checks for that permission will return `false`. 
+You may want to disable a permission based on a condition. Disabled permissions are not visible on the UI and always returns `prohibited` when you check them
+
+Permission conditions can be managed according to a condition such as a Feature, Global Feature, or a custom condition. Any condition which implements `IPermissionStateProvider` can be added via calling `AddStateProvider()` method for **PermissionDefinition**.
+
+See examples below:
+
+- To depend on a Global Feature
+
+  ```csharp
+  var authorPermission = myGroup.AddPermission("Author_Management");
+  
+  // There are a couple of ways to do:
+  authorPermission.RequireGlobalFeatures("AuthorManagementFeature");
+  authorPermission.RequireGlobalFeatures(typeof(AuthorManagementFeature));
+  authorPermission.AddStateProviders(new RequireGlobalFeaturesPermissionStateProvider("AuthorManagementFeature"));
+  
+  // Even it can be depend on multiple:
+  authorPermission.RequireGlobalFeatures("BookStoreFeature", "AuthorManagementFeature");
+  authorPermission.RequireGlobalFeatures(requiresAll: true, "BookStoreFeature", "AuthorManagementFeature");
+  authorPermission.RequireGlobalFeatures(requiresAll: true, typeof(BookStoreFeature), (AuthorManagementFeature);
+  ```
+
+- To depend on a Feature
+
+  ```csharp
+  var authorPermission = myGroup.AddPermission("Author_Management");
+  
+  // Pre-defined State Provider can be used:
+  authorPermission.AddStateProviders(new RequireFeaturesPermissionStateProvider("BookStore.AuthorManagement"));
+  
+  // Also can be depend on multiple features
+  authorPermission.AddStateProviders(
+      new RequireFeaturesPermissionStateProvider("BookStore.Authors","BookStore.AuthorManagement"));
+  
+  authorPermission.AddStateProviders(
+      new RequireFeaturesPermissionStateProvider(requiresAll: true, "BookStore.Authors","BookStore.AuthorManagement"));
+  ```
+
+- To depend on a Custom Condition
+
+  ```csharp
+  var authorPermission = myGroup.AddPermission("Author_Management");
+  
+  // To depend on your custom condition
+  authorPermission.AddStateProviders(new MyCustomPermissionStateProvider());
+  ```
+
+  Custom condition class have to implement `IPermissionStateProvider`
 
 ## IAuthorizationService