Skip to content

Commit d62087d

Browse files
authored
Merge pull request #279899 from zhiyuanliang-ms/zhiyuanliang/promote-fm-doc
Azure App Configuration - Add more references for feature management docs
2 parents 399dc32 + 3240499 commit d62087d

12 files changed

+192
-45
lines changed

articles/azure-app-configuration/concept-feature-management.md

Lines changed: 38 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -74,19 +74,44 @@ To use feature flags effectively, you need to externalize all the feature flags
7474

7575
Azure App Configuration provides a centralized repository for feature flags. You can use it to define different kinds of feature flags and manipulate their states quickly and confidently. You can then use the App Configuration libraries for various programming language frameworks to easily access these feature flags from your application.
7676

77-
[The feature flags in an ASP.NET Core app](./use-feature-flags-dotnet-core.md) shows how the App Configuration .NET provider and Feature Management libraries are used together to implement feature flags for your ASP.NET web application. For more information on feature flags in Azure App Configuration, see the following articles:
78-
79-
* [Manage feature flags](./manage-feature-flags.md)
80-
* [Use conditional feature flags](./howto-feature-filters-aspnet-core.md)
81-
* [Enable a feature for specified users/groups](./howto-targetingfilter-aspnet-core.md)
82-
* [Add feature flags to an ASP.NET Core app](./quickstart-feature-flag-aspnet-core.md)
83-
* [Add feature flags to a .NET Framework app](./quickstart-feature-flag-dotnet.md)
84-
* [Add feature flags to an Azure Functions app](./quickstart-feature-flag-azure-functions-csharp.md)
85-
* [Add feature flags to a Spring Boot app](./quickstart-feature-flag-spring-boot.md)
86-
* [Use feature flags in an ASP.NET Core](./use-feature-flags-dotnet-core.md)
87-
* [Use feature flags in a Spring Boot app](./use-feature-flags-spring-boot.md)
88-
8977
## Next steps
9078

79+
To start using feature flags with Azure App Configuration, continue to the following quickstarts specific to your application’s language or platform.
80+
81+
> [!div class="nextstepaction"]
82+
> [ASP.NET Core](./quickstart-feature-flag-aspnet-core.md)
83+
9184
> [!div class="nextstepaction"]
92-
> [Add feature flags to an ASP.NET Core web app](./quickstart-feature-flag-aspnet-core.md)
85+
> [.NET/.NET Framework](./quickstart-feature-flag-dotnet.md)
86+
87+
> [!div class="nextstepaction"]
88+
> [.NET background service](./quickstart-feature-flag-dotnet-background-service.md)
89+
90+
> [!div class="nextstepaction"]
91+
> [Java Spring](./quickstart-feature-flag-spring-boot.md)
92+
93+
> [!div class="nextstepaction"]
94+
> [Python](./quickstart-feature-flag-python.md)
95+
96+
> [!div class="nextstepaction"]
97+
> [Azure Kubernetes Service](./quickstart-feature-flag-azure-kubernetes-service.md)
98+
99+
> [!div class="nextstepaction"]
100+
> [Azure Functions](./quickstart-feature-flag-azure-functions-csharp.md)
101+
102+
To learn more about managing feature flags in Azure App Configuration, continue to the following tutorial.
103+
104+
> [!div class="nextstepaction"]
105+
> [Manage feature flags in Azure App Configuration](./manage-feature-flags.md)
106+
107+
Feature filters allow you to enable a feature flag conditionally. Azure App Configuration offers built-in feature filters that enable you to activate a feature flag only during a specific period or to a particular targeted audience of your app. For more information, continue to the following tutorial.
108+
109+
> [!div class="nextstepaction"]
110+
> [Enable conditional features with feature filters](./howto-feature-filters.md)
111+
112+
> [!div class="nextstepaction"]
113+
> [Enable features on a schedule](./howto-timewindow-filter.md)
114+
115+
> [!div class="nextstepaction"]
116+
> [Roll out features to targeted audiences](./howto-targetingfilter.md)
117+

articles/azure-app-configuration/feature-management-dotnet-reference.md

Lines changed: 38 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,17 @@
11
---
2-
title: .NET feature management - Azure App Configuration
3-
description: Overview of .NET Feature Management library
2+
title: .NET feature flag management
3+
titleSuffix: Azure App Configuration
4+
description: In this tutorial, you learn how to use feature flags in .NET apps. The feature management library provides various out-of-the-box solutions for application development, ranging from simple feature toggles to complex feature experimentation.
45
services: azure-app-configuration
56
author: zhiyuanliang-ms
67
ms.author: zhiyuanliang
78
ms.service: azure-app-configuration
9+
ms.devlang: csharp
810
ms.custom: devx-track-dotnet
911
ms.topic: tutorial
1012
ms.date: 05/22/2024
1113
zone_pivot_groups: feature-management
14+
#Customer intent: I want to control feature availability in my app by using the Feature Management library.
1215
---
1316

1417
# .NET Feature Management
@@ -323,10 +326,10 @@ By default, the feature manager retrieves feature flag configuration from the "F
323326

324327
> [!NOTE]
325328
> You can also specify that feature flag configuration should be retrieved from a different configuration section by passing the section to `AddFeatureManagement`. The following example tells the feature manager to read from a different section called "MyFeatureFlags" instead:
326-
327-
``` C#
328-
services.AddFeatureManagement(configuration.GetSection("MyFeatureFlags"));
329-
```
329+
>
330+
> ``` C#
331+
> services.AddFeatureManagement(configuration.GetSection("MyFeatureFlags"));
332+
> ```
330333
331334
### Dependency Injection
332335
@@ -1423,3 +1426,32 @@ To use an implementation of `IFeatureDefinitionProvider`, it must be added into
14231426
services.AddSingleton<IFeatureDefinitionProvider, InMemoryFeatureDefinitionProvider>()
14241427
.AddFeatureManagement()
14251428
```
1429+
1430+
## Next steps
1431+
1432+
To learn how to use feature flags in your applications, continue to the following quickstarts.
1433+
1434+
> [!div class="nextstepaction"]
1435+
> [ASP.NET Core](./quickstart-feature-flag-aspnet-core.md)
1436+
1437+
> [!div class="nextstepaction"]
1438+
> [.NET/.NET Framework console app](./quickstart-feature-flag-dotnet.md)
1439+
1440+
> [!div class="nextstepaction"]
1441+
> [.NET background service](./quickstart-feature-flag-dotnet-background-service.md)
1442+
1443+
To learn how to use feature filters, continue to the following tutorials.
1444+
1445+
> [!div class="nextstepaction"]
1446+
> [Enable conditional features with feature filters](./howto-feature-filters.md)
1447+
1448+
> [!div class="nextstepaction"]
1449+
> [Enable features on a schedule](./howto-timewindow-filter.md)
1450+
1451+
> [!div class="nextstepaction"]
1452+
> [Roll out features to targeted audiences](./howto-targetingfilter.md)
1453+
1454+
To learn how to run experiments with variant feature flags, continue to the following tutorial.
1455+
1456+
> [!div class="nextstepaction"]
1457+
> [Run experiments with variant feature flags](./howto-feature-filters.md)

articles/azure-app-configuration/howto-feature-filters-aspnet-core.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -94,3 +94,8 @@ To learn more about the built-in feature filters, continue to the following tuto
9494

9595
> [!div class="nextstepaction"]
9696
> [Roll out features to targeted audience](./howto-targetingfilter.md)
97+
98+
For the full feature rundown of the .NET feature management library, continue to the following document.
99+
100+
> [!div class="nextstepaction"]
101+
> [.NET Feature Management](./feature-management-dotnet-reference.md)

articles/azure-app-configuration/howto-targetingfilter-aspnet-core.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -228,3 +228,8 @@ To learn more about the feature filters, continue to the following tutorials.
228228
229229
> [!div class="nextstepaction"]
230230
> [Enable features on a schedule](./howto-timewindow-filter-aspnet-core.md)
231+
232+
For the full feature rundown of the .NET feature management library, continue to the following document.
233+
234+
> [!div class="nextstepaction"]
235+
> [.NET Feature Management](./feature-management-dotnet-reference.md)

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

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,3 +58,8 @@ To learn more about the feature filters, continue to the following tutorials.
5858
5959
> [!div class="nextstepaction"]
6060
> [Roll out features to targeted audience](./howto-targetingfilter.md)
61+
62+
For the full feature rundown of the .NET feature management library, continue to the following document.
63+
64+
> [!div class="nextstepaction"]
65+
> [.NET Feature Management](./feature-management-dotnet-reference.md)

articles/azure-app-configuration/manage-feature-flags.md

Lines changed: 22 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: "Use Azure App Configuration to manage feature flags"
2+
title: Use Azure App Configuration to manage feature flags
33
titleSuffix: Azure App Configuration
44
description: In this quickstart, you learn how to manage feature flags separately from your application by using Azure App Configuration.
55
services: azure-app-configuration
@@ -143,5 +143,25 @@ Feature flags created with the Feature manager are stored as regular key-values.
143143

144144
## Next steps
145145

146+
To start using feature flags with Azure App Configuration, continue to the following quickstarts specific to your application’s language or platform.
147+
148+
> [!div class="nextstepaction"]
149+
> [ASP.NET Core](./quickstart-feature-flag-aspnet-core.md)
150+
151+
> [!div class="nextstepaction"]
152+
> [.NET/.NET Framework](./quickstart-feature-flag-dotnet.md)
153+
154+
> [!div class="nextstepaction"]
155+
> [.NET background service](./quickstart-feature-flag-dotnet-background-service.md)
156+
157+
> [!div class="nextstepaction"]
158+
> [Java Spring](./quickstart-feature-flag-spring-boot.md)
159+
160+
> [!div class="nextstepaction"]
161+
> [Python](./quickstart-feature-flag-python.md)
162+
163+
> [!div class="nextstepaction"]
164+
> [Azure Kubernetes Service](./quickstart-feature-flag-azure-kubernetes-service.md)
165+
146166
> [!div class="nextstepaction"]
147-
> [Enable staged rollout of features for targeted audiences](./howto-targetingfilter-aspnet-core.md)
167+
> [Azure Functions](./quickstart-feature-flag-azure-functions-csharp.md)

articles/azure-app-configuration/quickstart-feature-flag-aspnet-core.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
---
2-
title: Quickstart for adding feature flags to ASP.NET Core
3-
description: Add feature flags to ASP.NET Core apps and manage them using Azure App Configuration
2+
title: Quickstart for adding feature flags to ASP.NET Core apps
3+
titleSuffix: Azure App Configuration
4+
description: This tutorial will guide you through the process of integrating feature flags from Azure App Configuration into your ASP.NET Core apps.
5+
services: azure-app-configuration
46
author: zhenlan
57
ms.service: azure-app-configuration
68
ms.devlang: csharp
@@ -180,25 +182,31 @@ Add a feature flag called *Beta* to the App Configuration store and leave **Labe
180182
181183
## Next steps
182184
183-
In this quickstart, you added feature management capability to an ASP.NET Core app on top of dynamic configuration. The [Microsoft.FeatureManagement.AspNetCore](https://www.nuget.org/packages/Microsoft.FeatureManagement.AspNetCore) library offers rich integration for ASP.NET Core apps, including feature management in MVC controller actions, razor pages, views, routes, and middleware. For more information, continue to the following tutorial.
185+
In this quickstart, you added feature management capability to an ASP.NET Core app on top of dynamic configuration. The [Microsoft.FeatureManagement.AspNetCore](https://www.nuget.org/packages/Microsoft.FeatureManagement.AspNetCore) library offers rich integration for ASP.NET Core apps, including feature management in MVC controller actions, razor pages, views, routes, and middleware. For the full feature rundown of the .NET feature management library, continue to the following document.
184186
185187
> [!div class="nextstepaction"]
186-
> [Use feature flags in ASP.NET Core apps](./use-feature-flags-dotnet-core.md)
188+
> [.NET Feature Management](./feature-management-dotnet-reference.md)
187189
188190
While a feature flag allows you to activate or deactivate functionality in your app, you may want to customize a feature flag based on your app's logic. Feature filters allow you to enable a feature flag conditionally. For more information, continue to the following tutorial.
189191
190192
> [!div class="nextstepaction"]
191-
> [Use feature filters for conditional feature flags](./howto-feature-filters-aspnet-core.md)
193+
> [Enable conditional features with feature filters](./howto-feature-filters.md)
192194
193195
Azure App Configuration offers built-in feature filters that enable you to activate a feature flag only during a specific period or to a particular targeted audience of your app. For more information, continue to the following tutorial.
194196
195197
> [!div class="nextstepaction"]
196-
> [Enable features for targeted audiences](./howto-targetingfilter-aspnet-core.md)
198+
> [Enable features on a schedule](./howto-timewindow-filter.md)
199+
200+
> [!div class="nextstepaction"]
201+
> [Roll out features to targeted audiences](./howto-targetingfilter.md)
197202
198203
To enable feature management capability for other types of apps, continue to the following tutorials.
199204
200205
> [!div class="nextstepaction"]
201-
> [Use feature flags in .NET apps](./quickstart-feature-flag-dotnet.md)
206+
> [Use feature flags in .NET/.NET Framework console apps](./quickstart-feature-flag-dotnet.md)
207+
208+
> [!div class="nextstepaction"]
209+
> [Use feature flags in .NET background services](./quickstart-feature-flag-dotnet-background-service.md)
202210
203211
> [!div class="nextstepaction"]
204212
> [Use feature flags in Azure Functions](./quickstart-feature-flag-azure-functions-csharp.md)

articles/azure-app-configuration/quickstart-feature-flag-azure-functions-csharp.md

Lines changed: 21 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -213,10 +213,25 @@ This project will use [dependency injection in .NET Azure Functions](../azure-fu
213213

214214
## Next steps
215215

216-
In this quickstart, you created a feature flag and used it with an Azure Functions app via the [Microsoft.FeatureManagement](https://www.nuget.org/packages/Microsoft.FeatureManagement/) library.
216+
In this quickstart, you created a feature flag and used it with an Azure Functions.
217217

218-
- Learn more about [feature management](./concept-feature-management.md)
219-
- [Manage feature flags](./manage-feature-flags.md)
220-
- [Use conditional feature flags](./howto-feature-filters-aspnet-core.md)
221-
- [Enable staged rollout of features for targeted audiences](./howto-targetingfilter-aspnet-core.md)
222-
- [Use dynamic configuration in an Azure Functions app](./enable-dynamic-configuration-azure-functions-csharp.md)
218+
To enable feature management capability for other types of apps, continue to the following tutorials.
219+
220+
> [!div class="nextstepaction"]
221+
> [Use feature flags in ASP.NET Core apps](./quickstart-feature-flag-aspnet-core.md)
222+
223+
> [!div class="nextstepaction"]
224+
> [Use feature flags in .NET/.NET framework console apps](./quickstart-feature-flag-dotnet.md)
225+
226+
> [!div class="nextstepaction"]
227+
> [Use feature flags in .NET background services](./quickstart-feature-flag-dotnet-background-service.md)
228+
229+
To learn more about managing feature flags in Azure App Configuration, continue to the following tutorial.
230+
231+
> [!div class="nextstepaction"]
232+
> [Manage feature flags in Azure App Configuration](./manage-feature-flags.md)
233+
234+
For the full feature rundown of the .NET feature management library, continue to the following document.
235+
236+
> [!div class="nextstepaction"]
237+
> [.NET Feature Management](./feature-management-dotnet-reference.md)

articles/azure-app-configuration/quickstart-feature-flag-dotnet-background-service.md

Lines changed: 9 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -173,15 +173,22 @@ Add a feature flag called *Beta* to the App Configuration store and leave **Labe
173173
174174
## Next steps
175175
176+
In this quickstart, you created a feature flag and used it with a background service.
177+
176178
To enable feature management capability for other types of apps, continue to the following tutorials.
177179
178180
> [!div class="nextstepaction"]
179-
> [Use feature flags in .NET console apps](./quickstart-feature-flag-dotnet.md)
181+
> [Use feature flags in ASP.NET Core apps](./quickstart-feature-flag-aspnet-core.md)
180182
181183
> [!div class="nextstepaction"]
182-
> [Use feature flags in ASP.NET Core apps](./quickstart-feature-flag-aspnet-core.md)
184+
> [Use feature flags in .NET/.NET framework console apps](./quickstart-feature-flag-dotnet.md)
183185
184186
To learn more about managing feature flags in Azure App Configuration, continue to the following tutorial.
185187
186188
> [!div class="nextstepaction"]
187189
> [Manage feature flags in Azure App Configuration](./manage-feature-flags.md)
190+
191+
For the full feature rundown of the .NET feature management library, continue to the following document.
192+
193+
> [!div class="nextstepaction"]
194+
> [.NET Feature Management](./feature-management-dotnet-reference.md)

articles/azure-app-configuration/quickstart-feature-flag-dotnet.md

Lines changed: 12 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -166,10 +166,21 @@ You can use Visual Studio to create a new console app project.
166166
167167
In this quickstart, you created a feature flag in App Configuration and used it with a console app. To learn how to dynamically update feature flags and other configuration values without restarting the application, continue to the next tutorial.
168168
169-
170169
> [!div class="nextstepaction"]
171170
> [Enable dynamic configuration in a .NET app](./enable-dynamic-configuration-dotnet-core.md)
172171
173172
> [!div class="nextstepaction"]
174173
> [Enable dynamic configuration in a .NET Framework app](./enable-dynamic-configuration-dotnet.md)
175174
175+
To enable feature management capability for other types of apps, continue to the following tutorials.
176+
177+
> [!div class="nextstepaction"]
178+
> [Use feature flags in ASP.NET Core apps](./quickstart-feature-flag-aspnet-core.md)
179+
180+
> [!div class="nextstepaction"]
181+
> [Use feature flags in .NET background services](./quickstart-feature-flag-dotnet-background-service.md)
182+
183+
For the full feature rundown of the .NET feature management library, continue to the following document.
184+
185+
> [!div class="nextstepaction"]
186+
> [.NET Feature Management](./feature-management-dotnet-reference.md)

0 commit comments

Comments
 (0)