update documentation

Author: amirkaws

docs/utilities/parameters.md

@@ -133,65 +133,6 @@ in order to get data from other regions or use specific credentials.
     }
     ```
 
-## App Configurations
-
-For application configurations in AWS AppConfig, use `AppConfigProvider`.
-
-Alternatively, you can retrieve the instance of provider and configure its underlying SDK client,
-in order to get data from other regions or use specific credentials.
-
-
-=== "AppConfigProvider"
-
-     ```c# hl_lines="10-13 16-18"
-    using AWS.Lambda.Powertools.Parameters;
-    using AWS.Lambda.Powertools.Parameters.AppConfig;
-
-    public class Function
-    {
-        public async Task<APIGatewayProxyResponse> FunctionHandler
-            (APIGatewayProxyRequest apigProxyEvent, ILambdaContext context)
-        {
-            // Get AppConfig Provider instance
-            IAppConfigProvider appConfigProvider = ParametersManager.AppConfigProvider
-                .DefaultApplication("MyApplicationId")
-                .DefaultEnvironment("MyEnvironmentId")
-                .DefaultConfigProfile("MyConfigProfileId");
-                
-            // Retrieve a single configuration, latest version
-            IDictionary<string, string?> value = await appConfigProvider
-                .GetAsync()
-                .ConfigureAwait(false);
-        }
-    }
-    ```
-
-=== "AppConfigProvider with an explicit region"
-
-     ```c# hl_lines="10-14"
-    using AWS.Lambda.Powertools.Parameters;
-    using AWS.Lambda.Powertools.Parameters.AppConfig;
-
-    public class Function
-    {
-        public async Task<APIGatewayProxyResponse> FunctionHandler
-            (APIGatewayProxyRequest apigProxyEvent, ILambdaContext context)
-        {
-            // Get AppConfig Provider instance
-            IAppConfigProvider appConfigProvider = ParametersManager.AppConfigProvider
-                .ConfigureClient(RegionEndpoint.EUCentral1)
-                .DefaultApplication("MyApplicationId")
-                .DefaultEnvironment("MyEnvironmentId")
-                .DefaultConfigProfile("MyConfigProfileId");
-                
-            // Retrieve a single configuration, latest version
-            IDictionary<string, string?> value = await appConfigProvider
-                .GetAsync()
-                .ConfigureAwait(false);
-        }
-    }
-    ```
-
 ### Additional arguments
 
 The AWS Systems Manager Parameter Store provider supports two additional arguments for the `Get()` and `GetMultiple()` methods:
@@ -401,6 +342,7 @@ You can retrieve multiple parameters sharing the same `id` by having a sort key
 		"param-b": "my-value-b",
 		"param-c": "my-value-c"
 	}
+    ```
 
 **Customizing DynamoDBProvider**
 
@@ -437,6 +379,106 @@ DynamoDB provider can be customized at initialization to match your table struct
     }
     ```
 
+## App Configurations
+
+For application configurations in AWS AppConfig, use `AppConfigProvider`.
+
+Alternatively, you can retrieve the instance of provider and configure its underlying SDK client,
+in order to get data from other regions or use specific credentials.
+
+=== "AppConfigProvider"
+
+     ```c# hl_lines="10-13 16-18"
+    using AWS.Lambda.Powertools.Parameters;
+    using AWS.Lambda.Powertools.Parameters.AppConfig;
+
+    public class Function
+    {
+        public async Task<APIGatewayProxyResponse> FunctionHandler
+            (APIGatewayProxyRequest apigProxyEvent, ILambdaContext context)
+        {
+            // Get AppConfig Provider instance
+            IAppConfigProvider appConfigProvider = ParametersManager.AppConfigProvider
+                .DefaultApplication("MyApplicationId")
+                .DefaultEnvironment("MyEnvironmentId")
+                .DefaultConfigProfile("MyConfigProfileId");
+                
+            // Retrieve a single configuration, latest version
+            IDictionary<string, string?> value = await appConfigProvider
+                .GetAsync()
+                .ConfigureAwait(false);
+        }
+    }
+    ```
+
+=== "AppConfigProvider with an explicit region"
+
+     ```c# hl_lines="10-14"
+    using AWS.Lambda.Powertools.Parameters;
+    using AWS.Lambda.Powertools.Parameters.AppConfig;
+
+    public class Function
+    {
+        public async Task<APIGatewayProxyResponse> FunctionHandler
+            (APIGatewayProxyRequest apigProxyEvent, ILambdaContext context)
+        {
+            // Get AppConfig Provider instance
+            IAppConfigProvider appConfigProvider = ParametersManager.AppConfigProvider
+                .ConfigureClient(RegionEndpoint.EUCentral1)
+                .DefaultApplication("MyApplicationId")
+                .DefaultEnvironment("MyEnvironmentId")
+                .DefaultConfigProfile("MyConfigProfileId");
+                
+            // Retrieve a single configuration, latest version
+            IDictionary<string, string?> value = await appConfigProvider
+                .GetAsync()
+                .ConfigureAwait(false);
+        }
+    }
+    ```
+
+**Using AWS AppConfig Feature Flags**
+
+Feature flagging is a powerful tool that allows safely pushing out new features in a measured and usually gradual way. AppConfig provider offers helper methods to make it easier to work with feature flags.
+
+=== "AppConfigProvider"
+
+     ```c# hl_lines="10-13 16-18 23-25"
+    using AWS.Lambda.Powertools.Parameters;
+    using AWS.Lambda.Powertools.Parameters.AppConfig;
+
+    public class Function
+    {
+        public async Task<APIGatewayProxyResponse> FunctionHandler
+            (APIGatewayProxyRequest apigProxyEvent, ILambdaContext context)
+        {
+            // Get AppConfig Provider instance
+            IAppConfigProvider appConfigProvider = ParametersManager.AppConfigProvider
+                .DefaultApplication("MyApplicationId")
+                .DefaultEnvironment("MyEnvironmentId")
+                .DefaultConfigProfile("MyConfigProfileId");
+                
+            // Check if feature flag is enabled
+            var isFeatureFlagEnabled = await appConfigProvider
+                .IsFeatureFlagEnabledAsync("MyFeatureFlag")
+                .ConfigureAwait(false);
+            
+            if (isFeatureFlagEnabled)
+            {
+                // Retrieve an attribute value of the feature flag
+                var strAttValue = await appConfigProvider
+                    .GetFeatureFlagAttributeValueAsync<string>("MyFeatureFlag", "StringAttribute")
+                    .ConfigureAwait(false);
+                
+                // Retrieve another attribute value of the feature flag
+                var numberAttValue = await appConfigProvider
+                    .GetFeatureFlagAttributeValueAsync<int>("MyFeatureFlag", "NumberAttribute")
+                    .ConfigureAwait(false);
+            }
+        }
+    }
+    ```
+
 ## Advanced configuration
 
 ### Caching