Merge branch 'ml-acrecurring'

Author: maud-lv

articles/azure-app-configuration/howto-timewindow-filter.md

@@ -1,45 +1,61 @@
 ---
 title: Enable features on a schedule
 titleSuffix: Azure App Configuration
-description: Learn how to enable feature flags on a schedule.
+description: Learn how to enable feature flags on a schedule using time window filters in Azure App Configuration.
 ms.service: azure-app-configuration
 ms.devlang: csharp
 author: zhiyuanliang-ms
 ms.author: zhiyuanliang
 ms.topic: how-to
-ms.date: 03/26/2024
+ms.date: 10/31/2024
+#customer intent: As an application developer, I want to enable a recurring time window filter in a feature flag so that I can enable or disable features on a schedule.
 ---
 
-# Tutorial: Enable features on a schedule
+# Enable features on a schedule
 
 [Feature filters](./howto-feature-filters.md#what-is-a-feature-filter) allow a feature flag to be enabled or disabled conditionally. The time window filter is one of the feature management library's built-in feature filters. It allows you to turn on or off a feature on a schedule. For example, when you have a new product announcement, you can use it to unveil a feature automatically at a planned time. You can also use it to discontinue a promotional discount as scheduled after the marketing campaign ends.
 
-In this article, you will learn how to add and configure a time window filter for your feature flags.
+In this article, you learn how to add and configure a time window filter for your feature flags.
 
 ## Add a time window filter
 
-1. Create a feature flag named *Beta* in your App Configuration store and open to edit it. For more information about how to add and edit a feature flag, see [Manage feature flags](./manage-feature-flags.md).
+1. Create a feature flag named *Beta* in the **Feature Manager** menu of your App Configuration store and move to the right end of the feature flag you want to modify, then select the **More actions** ellipsis (**...**) action and **Edit**. For more information about how to add and edit a feature flag, see [Manage feature flags](./manage-feature-flags.md).
 
-1. In the **Edit feature flag** pane that opens, check the **Enable feature flag** checkbox if it isn't already enabled. Then check the **Use feature filter** checkbox and select **Create**.
+1. In the **Edit** pane that opens, check the **Enable feature flag** checkbox if it's currently unchecked,then check the **Use feature filter** checkbox and select **Create**.
 
-    > [!div class="mx-imgBorder"]
-    > ![Screenshot of the Azure portal, filling out the form 'Edit feature flag'.](./media/feature-filters/edit-a-feature-flag.png)
+    :::image type="content" source="media/time-window-filters/edit-a-feature-flag.png" alt-text="Screenshot of the Azure portal showing how to edit a feature flag.":::
 
-1. The pane **Create a new filter** opens. Under **Filter type**, select the **Time window filter** in the dropdown.
+1. The **Create a new filter** pane opens on the side. Under **Filter type**, select **Time window filter** in the dropdown.
 
-    > [!div class="mx-imgBorder"]
-    > ![Screenshot of the Azure portal, creating a new time window filter.](./media/feature-filters/add-timewindow-filter.png)
+    :::image type="content" source="media/time-window-filters/add-timewindow-filter.png" alt-text="Screenshot of the Azure portal showing time window feature filter configuration.":::
+
+1. A time window filter includes a start time and/or an end time. Both **Start time** and **End time** checkboxes are checked by default.
+   - Setting a start time allows you to enable the feature flag on a specific date and time. A time window filter with no start time is active as soon as you save the feature filter details. 
+   - Setting an end time allows you to disable the feature flag at a specific date and time. A time window filter with no end time remains active until you disable it. 
+
+    Uncheck the end time and enter a start time a few minutes ahead of your current time to schedule the *Beta* feature to be enabled automatically in a few minutes and never be disabled once enabled.
+
+1. A time zone is selected by default, based on your browser's current time zone. Optionally select another time zone.
+
+## Enable recurrence
+
+Setting a time window recurrence allows you to define a repeating time window, ensuring that the feature flag is automatically activated and deactivated according to your specified schedule, such as during periods of low or high traffic. 
+
+1. A recurring time window filter always has a start time and an end time, defining a base time window that recurs according to the recurrence pattern you specified. Enter a **Start time** and an **End time**, then select the **Enable recurrence** checkbox, and select the recurrence details, including a frequency and an expiration time.
+
+   In this example, we activate the *Beta* feature **Daily** from November 25, every night between 8:00 PM and 6:00 AM. You can alternatively select a weekly frequency and select one or more days of the week for the recurrence. We set an **expiration time** a few weeks later.
+
+    :::image type="content" source="media/time-window-filters/add-timewindow-filter-recurrence.png" alt-text="Screenshot of the Azure portal showing feature filter recurrence.":::
 
-1. A time window filter includes two parameters: start and expiry date. Set the **Start date** to **Custom** and select a time a few minutes ahead of your current time. Set the **Expiry date** to **Never**. In this example, you schedule the *Beta* feature to be enabled automatically at a future time, and it will never be disabled once enabled.
 
 1. Select **Add** to save the configuration of the time window filter and return to the **Edit feature flag** screen.
 
-1. The time window filter is now listed in the feature flag details. Select **Apply** to save the feature flag.
+1. The time window filter is now listed in the feature filter details, under **Feature filters**. Select **Apply** to save the feature flag with the new feature filter.
 
     > [!div class="mx-imgBorder"]
-    > ![Screenshot of the Azure portal, applying new time window filter.](./media/feature-filters/feature-flag-edit-apply-timewindow-filter.png)
+    > ![Screenshot of the Azure portal, applying new time window filter.](./media/time-window-filters/feature-flag-edit-apply-timewindow-filter.png)
 
-    Now, you successfully added a time window filter to a feature flag. 
+    Now, you successfully added a time window filter to a feature flag.
 
 1. Continue to the following instructions to use the feature flag with a time window filter in your application for the language or platform you are using.