Merge pull request #177215 from ggailey777/patch-1

Clean-up of the MSI tutorials

Author: PRMerger20

articles/azure-functions/functions-identity-based-connections-tutorial-2.md

@@ -1,24 +1,19 @@
 ---
-title: Use identity-based connections instead of secrets with triggers and bindings
-titleSuffix: Azure Functions
-description: Learn how to use identity-based connections instead of connection strings with a Service Bus queue trigger
+title: Use identity-based connections with Azure Functions triggers and bindings
+ms.service: azure-functions
+description: Learn how to use identity-based connections instead of connection strings when connecting to a Service Bus queue using Azure Functions.
 ms.topic: tutorial
 ms.date: 10/20/2021
 #Customer intent: As a function developer, I want to learn how to use managed identities so that I can avoid having to handle connection strings in my application settings.
 ---
 
 # Tutorial: Use identity-based connections instead of secrets with triggers and bindings
 
-This tutorial shows you how to configure Azure Functions to trigger off of Azure Service Bus queues using managed identities instead of secrets stored in the function app settings. The tutorial is a continuation of the [Create a function app without default storage secrets in its definition][previous tutorial] tutorial. To learn more about identity-based connections, see [Configure an identity-based connection.](functions-reference.md#configure-an-identity-based-connection).
+This tutorial shows you how to configure Azure Functions to connect to Azure Service Bus queues using managed identities instead of secrets stored in the function app settings. The tutorial is a continuation of the [Create a function app without default storage secrets in its definition][previous tutorial] tutorial. To learn more about identity-based connections, see [Configure an identity-based connection.](functions-reference.md#configure-an-identity-based-connection).
 
 While the procedures shown work generally for all languages, this tutorial currently supports C# class library functions on Windows specifically. 
 
-This tutorial has two parts:
-
-1. [Create a function app without default storage secrets in its definition][previous tutorial]
-2. Use identity-based connections instead of secrets with triggers and bindings (this article)
-
-In Part 2, you'll learn how to:
+In this tutorial, you'll learn how to:
 
 > [!div class="checklist"]
 >
@@ -30,13 +25,7 @@ In Part 2, you'll learn how to:
 
 ## Prerequisite
 
-+ An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
-
-+ The [.NET Core 3.1 SDK](https://dotnet.microsoft.com/download)
-
-+ The [Azure Functions Core Tools](functions-run-local.md#v2) version 3.x.
-
-+ Have an existing function app with a system-assigned identity. For steps on how to do this follow part 1 of the tutorial: [Create a function app with identity-based connections][previous tutorial].
+Complete the previous tutorial: [Create a function app with identity-based connections][previous tutorial].
 
 ## Create a service bus and queue
 
@@ -95,7 +84,7 @@ You've granted your function app access to the service bus namespace using manag
 
 ## Connect to Service Bus in your function app
 
-1. In the portal, search for your pre-existing function app. If you completed the [previous tutorial], use that app. You can also browse to it in the **Function App** page.
+1. In the portal, search for the function app you created in the [previous tutorial], or browse to it in the **Function App** page.
 
 1. In your function app, select **Configuration** under **Settings**.
 
@@ -206,7 +195,7 @@ In this tutorial, you created a function app with identity-based connections.
 Use the following links to learn more Azure Functions with identity-based connections:
 
 - [Managed identity in Azure Functions](../app-service/overview-managed-identity.md)
-- [identity-based connections in Azure Functions](./functions-reference.md#configure-an-identity-based-connection)
+- [Identity-based connections in Azure Functions](./functions-reference.md#configure-an-identity-based-connection)
 - [Functions documentation for local development](./functions-reference.md#local-development-with-identity-based-connections)
 
-[previous tutorial]: ./functions-identity-based-connections-tutorial.md
+[previous tutorial]: ./functions-identity-based-connections-tutorial.md

articles/azure-functions/functions-identity-based-connections-tutorial.md

@@ -1,6 +1,7 @@
 ---
 title: Create a function app without default storage secrets in its definition
 titleSuffix: Azure Functions
+ms.service: azure-functions
 description: Learn how to remove Storage connection strings from your function app definition.
 ms.topic: tutorial
 ms.date: 10/20/2021
@@ -13,19 +14,16 @@ This tutorial shows you how to configure a function app using Azure Active Direc
 
 While the procedures shown work generally for all languages, this tutorial currently supports C# class library functions on Windows specifically. 
 
-This tutorial has two parts:
-
-1. Create a function app without default storage secrets in its definition (this article)
-2. [Use identity-based connections instead of secrets with triggers and bindings]
-
-In Part 1, you'll learn how to:
+In this tutorial, you learn how to:
 > [!div class="checklist"]
 > * Create a function app in Azure using an ARM template
 > * Enable both system-assigned and user-assigned managed identities on the function app
 > * Create role assignments that give permissions to other resources
 > * Move secrets that can't be replaced with identities into Azure Key Vault
 > * Configure an app to connect to the default host storage using its managed identity
 
+After you complete this tutorial, you should complete the follow-on tutorial that shows how to [use identity-based connections instead of secrets with triggers and bindings]. 
+
 ## Prerequisites
 
 + An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=visualstudio).
@@ -318,11 +316,9 @@ You've removed the storage connection string requirement for AzureWebJobsStorage
 
 This tutorial showed how to create a function app without storing secrets in its configuration.
 
-Advance to Part 2 to learn how to use identity-based connections from the triggers and bindings.
+In the next tutorial, you'll learn how to use identity in trigger and binding connections.
 
 > [!div class="nextstepaction"]
 > [Use identity-based connections instead of secrets with triggers and bindings]
 
-To learn more, see [Configure an identity-based connection](functions-reference.md#configure-an-identity-based-connection).
-
-[Use identity-based connections instead of secrets with triggers and bindings]: ./functions-identity-based-connections-tutorial-2.md
+[Use identity-based connections instead of secrets with triggers and bindings]: ./functions-identity-based-connections-tutorial-2.md