LinkFix: azure-dev-docs-pr (2022-07) (#3314)

cmcclister · KarlErickson · web-flow · commit 035f3829eccc · 2022-07-15T12:49:34.000-07:00
* LinkFix: azure-dev-docs-pr (2022-07)

* Update reference.md

* Apply suggestions from code review

Co-authored-by: Karl Erickson &lt;karler@microsoft.com&gt;
diff --git a/articles/azure-developer-cli/faq.yml b/articles/azure-developer-cli/faq.yml
@@ -73,7 +73,7 @@ sections:
           
           You can also go to https://portal.azure.com and then look for your resource group, which is `<your-environment-name>-rg`. If any of the deployments fail, select the error link to get more information.
           
-          For other resources, see [Troubleshoot common Azure deployment errors - Azure Resource Manager](https://docs.microsoft.com/azure/azure-resource-manager/troubleshooting/common-deployment-errors).
+          For other resources, see [Troubleshoot common Azure deployment errors - Azure Resource Manager](/azure/azure-resource-manager/troubleshooting/common-deployment-errors).
 
       - question: Is there a log file for `azd provision`? 
         answer: |
@@ -89,7 +89,7 @@ sections:
     questions:
       - question: Can I rerun `azd up`?
         answer: |
-          Yes. We use the [incremental deployment mode](https://docs.microsoft.com/azure/azure-resource-manager/templates/deployment-modes).
+          Yes. We use the [incremental deployment mode](/azure/azure-resource-manager/templates/deployment-modes).
 
       - question: How do I find the log file for `azd up`? 
         answer: |
@@ -99,7 +99,7 @@ sections:
     questions:
       - question: What is an Azure service principal?
         answer: |
-          An Azure service principal is an identity that's created for use with apps, hosted services, and automated tools to access Azure resources. This access is restricted by the roles that are assigned to the service principal, which gives you control over which resources can be accessed and at which level. For more information about authenticating from Azure to GitHub, see [Connect GitHub and Azure | Microsoft Docs](https://docs.microsoft.com/azure/developer/github/connect-from-azure?tabs=azure-portal%2Cwindows#use-the-azure-login-action-with-a-service-principal-secret). 
+          An Azure service principal is an identity that's created for use with apps, hosted services, and automated tools to access Azure resources. This access is restricted by the roles that are assigned to the service principal, which gives you control over which resources can be accessed and at which level. For more information about authenticating from Azure to GitHub, see [Connect GitHub and Azure | Microsoft Docs](../github/connect-from-azure.md?tabs=azure-portal%2cwindows#use-the-azure-login-action-with-a-service-principal-secret). 
 
       - question: Do I need to create an Azure service principal before I run `azd pipeline config`?
         answer: |
@@ -137,4 +137,4 @@ sections:
 
       - question: Where can I find the log for the GitHub Actions job that I triggered when I ran `azd pipeline config`?
         answer: |
-          Go to `https://github.com/<your-GH-account>/<your-repo>/actions`, and then refer to the log file in the workflow run.
+          Go to `https://github.com/<your-GH-account>/<your-repo>/actions`, and then refer to the log file in the workflow run.
diff --git a/articles/azure-developer-cli/overview.md b/articles/azure-developer-cli/overview.md
@@ -60,7 +60,7 @@ This list is grouped by supported language. Each repository contains a complete
 
 ## Azure Developer CLI vs Azure CLI
 
-[Azure Developer CLI (azd)](/azure/developer/azure-developer-cli) and [Azure CLI](/cli/azure/what-is-azure-cli) are both command-line tools.
+[Azure Developer CLI (azd)](./index.yml) and [Azure CLI](/cli/azure/what-is-azure-cli) are both command-line tools.
 
 However, they help you do different tasks.
 
@@ -104,4 +104,4 @@ Currently supported/planned languages:
 ## Next steps
 
 > [!div class="nextstepaction"] 
-> [Get started using Azure Developer CLI (azd)](get-started.md)
+> [Get started using Azure Developer CLI (azd)](get-started.md)
diff --git a/articles/azure-developer-cli/reference.md b/articles/azure-developer-cli/reference.md
@@ -37,7 +37,7 @@ azd deploy
 azd monitor --overview
 ```
 	
-For more information, visit the [Azure Developer CLI Dev Hub](https://aka.ms/azure-dev/devhub).
+For more information, visit the [Azure Developer CLI Dev Hub](./overview.md).
 
 ### Options
 
@@ -516,7 +516,7 @@ azd monitor -–live
 azd monitor --logs
 ```
 
-For more information, go to [https://aka.ms/azure-dev/monitor](https://aka.ms/azure-dev/monitor).
+For more information, see [Monitor your app using Azure Developer CLI (azd)](./monitor-your-app.md).
 
 ```
 azd monitor [flags]
@@ -554,7 +554,7 @@ Manage GitHub Actions pipelines.
 
 The Azure Developer CLI template includes a GitHub Actions pipeline configuration file (in the `.github/workflows` directory) that deploys your app whenever code is pushed to the main branch.
 		
-For more information, go to [https://aka.ms/azure-dev/pipeline](https://aka.ms/azure-dev/pipeline).
+For more information, see [Configure a pipeline and push updates using GitHub Actions](./configure-devops-pipeline.md).
 
 ### Options
 
@@ -584,7 +584,7 @@ Create and configure your deployment pipeline by using GitHub Actions.
 
 Create and configure your deployment pipeline by using GitHub Actions.
 		
-For more information, go to [https://aka.ms/azure-dev/pipeline](https://aka.ms/azure-dev/pipeline).
+For more information, see [Configure a pipeline and push updates using GitHub Actions](./configure-devops-pipeline.md).
 
 ```
 azd pipeline config [flags]
@@ -664,7 +664,7 @@ Restore app dependencies.
 
 Run this command to download and install all the required libraries so that you can build, run, and debug the app locally.
 
-For the best local run and debug experience, see [Debug by using the Visual Studio Code extension](https://aka.ms/azure-dev/vscode).
+For the best local run and debug experience, see [Debug by using the Visual Studio Code extension](./debug.md?pivots=ide-vs-code).
 
 ```
 azd restore [flags]
diff --git a/articles/github/index.yml b/articles/github/index.yml
@@ -53,11 +53,11 @@ landingContent:
       - linkListType: deploy
         links:
           - text: What is Azure Developer CLI?
-            url: /azure/developer/azure-developer-cli/overview 
+            url: ../azure-developer-cli/overview.md
           - text: Get started
-            url: /azure/developer/azure-developer-cli/get-started 
+            url: ../azure-developer-cli/get-started.md
           - text: See more in the Azure Developer CLI developer center
-            url: /azure/developer/azure-developer-cli/ 
+            url: ../azure-developer-cli/index.yml
 
   # Card (optional)
   # - title: Visual Studio and Visual Studio Code
@@ -81,4 +81,4 @@ landingContent:
       - linkListType: get-started
         links:
           - text: Manage Azure Policies as code with GitHub
-            url: manage-azure-policy.md  
+            url: manage-azure-policy.md
diff --git a/articles/index.yml b/articles/index.yml
@@ -48,7 +48,7 @@ productDirectory:
       links:
         - url: /azure/azure-functions/create-first-function-vs-code-python
           text: Deploy serverless Python apps to Azure Functions
-        - url: ./python/tutorial-deploy-app-service-on-linux-01.md
+        - url: ./python/configure-python-web-app-local-environment.md
           text: Deploy Python apps to Azure App Service
         - url: /azure/storage/blobs/storage-quickstart-blobs-python
           text: Manage storage blobs with the Azure SDK for Python
@@ -164,11 +164,11 @@ productDirectory:
     - title: Azure Developer CLI (azd) Preview
       imageSrc: https://static.docs.com/ui/media/product/azure/azure-developer-cli.svg
       links:
-        - url: /azure/developer/azure-developer-cli/overview
+        - url: ./azure-developer-cli/overview.md
           text: What is Azure Developer CLI
-        - url: /azure/developer/azure-developer-cli/get-started
+        - url: ./azure-developer-cli/get-started.md
           text: Get started
-        - url: /azure/developer/azure-developer-cli/
+        - url: ./azure-developer-cli/index.yml
           text: See more in the Azure Developer CLI developer center
 #tools:
 #conceptualContent:
diff --git a/articles/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub.md b/articles/java/spring-framework/configure-spring-cloud-stream-binder-java-app-kafka-azure-event-hub.md
@@ -13,7 +13,7 @@ ms.custom: devx-track-java
 
 This article shows you how to configure a Java-based Spring Cloud Stream Binder to use [Apache Kafka](http://kafka.apache.org) with Azure Event Hubs. In this article, you'll create the project by using Spring Initializr and deploy to Azure Spring Apps using Managed Identity.
 
-By using [Apache Kafka](http://kafka.apache.org) with Azure Event Hubs, you can take advantage of Spring Cloud Azure to use various types of credentials for authentication. For more information, see [Spring Cloud Azure authentication](/azure/developer/java/spring-framework/spring-cloud-azure?tabs=maven#spring-cloud-azure-authentication).
+By using [Apache Kafka](http://kafka.apache.org) with Azure Event Hubs, you can take advantage of Spring Cloud Azure to use various types of credentials for authentication. For more information, see [Spring Cloud Azure authentication](./spring-cloud-azure.md?tabs=maven#spring-cloud-azure-authentication).
 
 ## Prerequisites
 
@@ -369,4 +369,4 @@ For more information about Azure support for event hub Stream Binder and Apache
 
 For more information about using Azure with Java, see the [Azure for Java Developers] and the [Working with Azure DevOps and Java](/azure/devops/).
 
-The [Spring Framework](https://spring.io/) is an open-source solution that helps Java developers create enterprise-level applications. One of the more-popular projects that is built on top of that platform is [Spring Boot](https://spring.io/projects/spring-boot/), which provides a simplified approach for creating stand-alone Java applications. To help developers get started with Spring Boot, several sample Spring Boot packages are available in the [Spring Guides](https://github.com/spring-guides) collection of repositories on GitHub. In addition to choosing from the list of basic Spring Boot projects, the [Spring Initializr](https://start.spring.io/) helps developers get started with creating custom Spring Boot applications.
+The [Spring Framework](https://spring.io/) is an open-source solution that helps Java developers create enterprise-level applications. One of the more-popular projects that is built on top of that platform is [Spring Boot](https://spring.io/projects/spring-boot/), which provides a simplified approach for creating stand-alone Java applications. To help developers get started with Spring Boot, several sample Spring Boot packages are available in the [Spring Guides](https://github.com/spring-guides) collection of repositories on GitHub. In addition to choosing from the list of basic Spring Boot projects, the [Spring Initializr](https://start.spring.io/) helps developers get started with creating custom Spring Boot applications.
diff --git a/articles/java/spring-framework/includes/spring-cloud-azure/kafka-support.md b/articles/java/spring-framework/includes/spring-cloud-azure/kafka-support.md
@@ -65,7 +65,7 @@ The following list shows all supported configuration options.
   - Prefix: `spring.cloud.azure`
   - Supported options: `spring.cloud.azure.credential.*`, `spring.cloud.azure.profile.*`
 
-  For the full list of global configuration options, see the [Global properties](/azure/developer/java/spring-framework/spring-cloud-azure-appendix#global-properties) section.
+  For the full list of global configuration options, see the [Global properties](../../spring-cloud-azure-appendix.md#global-properties) section.
 
 - Spring Boot Kafka common configuration
 
@@ -317,4 +317,4 @@ spring:
 
 ### Samples
 
-See the [azure-spring-boot-samples](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/spring-cloud-azure_4.3.0) repository on GitHub.
+See the [azure-spring-boot-samples](https://github.com/Azure-Samples/azure-spring-boot-samples/tree/spring-cloud-azure_4.3.0) repository on GitHub.
diff --git a/articles/lab/includes/python-tutorial-multipage/intro.md b/articles/lab/includes/python-tutorial-multipage/intro.md
@@ -9,4 +9,4 @@ ms.custom: devx-track-javascript
 In this quickstart, you deploy a Python web app to [App Service on Linux](/azure/app-service/overview#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the local [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) on a Mac, Linux, or Windows computer to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
 
 > [!TIP]
-> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../../../python/tutorial-deploy-app-service-on-linux-01.md)**.
+> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../../../python/configure-python-web-app-local-environment.md)**.
diff --git a/articles/lab/quickstart-python-flask-minimized.md b/articles/lab/quickstart-python-flask-minimized.md
@@ -12,7 +12,7 @@ robots: noindex
 In this quickstart, you deploy a Python web app to [App Service on Linux](/azure/app-service/overview#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the local [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) on a Mac, Linux, or Windows computer to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
 
 > [!TIP]
-> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/tutorial-deploy-app-service-on-linux-01.md)**.
+> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/configure-python-web-app-local-environment.md)**.
 
 <details>
 <summary >1. Set up your initial environment</summary>
diff --git a/articles/lab/quickstart-python-flask.md b/articles/lab/quickstart-python-flask.md
@@ -12,7 +12,7 @@ robots: noindex
 In this quickstart, you deploy a Python web app to [App Service on Linux](/azure/app-service/overview#app-service-on-linux), Azure's highly scalable, self-patching web hosting service. You use the local [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) on a Mac, Linux, or Windows computer to deploy a sample with either the Flask or Django frameworks. The web app you configure uses a free App Service tier, so you incur no costs in the course of this article.
 
 > [!TIP]
-> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/tutorial-deploy-app-service-on-linux-01.md)**.
+> If you prefer using Visual Studio Code instead, follow our **[Visual Studio Code App Service quickstart](../python/configure-python-web-app-local-environment.md)**.
 
 ## 1. Set up your initial environment
 
@@ -235,4 +235,4 @@ The `--no-wait` argument allows the command to return before the operation is co
 > [Add user sign-in to a Python web app](/azure/active-directory/develop/quickstart-v2-python-webapp)
 
 > [!div class="nextstepaction"]
-> [Tutorial: Run Python app in custom container](/azure/app-service/tutorial-custom-container)
+> [Tutorial: Run Python app in custom container](/azure/app-service/tutorial-custom-container)
diff --git a/articles/python/configure-python-web-app-local-environment.md b/articles/python/configure-python-web-app-local-environment.md
@@ -127,7 +127,7 @@ In Python web app development, you often work with Python-based web frameworks.
 
 Three common Python web frameworks are [Django](https://www.djangoproject.com/), [Flask](https://flask.palletsprojects.com/en/2.1.x/), or [FastAPI](https://fastapi.tiangolo.com/). These and other web frameworks can be used with Azure.
 
-Below is an example of how you might get started quickly with these frameworks locally. Running these commands, you'll end up with an application, albeit a simple one that could be deployed to Azure. Run these commands inside a [virtual environment](/azure/developer/python/configure-local-development-environment#configure-python-virtual-environment).
+Below is an example of how you might get started quickly with these frameworks locally. Running these commands, you'll end up with an application, albeit a simple one that could be deployed to Azure. Run these commands inside a [virtual environment](./configure-local-development-environment.md#configure-python-virtual-environment).
 
 **Step 1:**  Download the frameworks with [pip](https://pip.pypa.io/en/stable/cli/pip_install/).
 ### [Django](#tab/django)
@@ -255,4 +255,4 @@ At this point, add a *requirements.txt* file and then you can deploy the web app
 
 * [Quickstart: Create a Python (Django or Flask) web app in Azure App Service](/azure/app-service/quickstart-python).
 * [Tutorial: Deploy a Python (Django or Flask) web app with PostgreSQL in Azure](/azure/app-service/tutorial-python-postgresql-app)
-* [Tutorial: Deploy a Python web app to Azure with managed identity](./tutorial-python-managed-identity-01.md)
+* [Tutorial: Deploy a Python web app to Azure with managed identity](./tutorial-python-managed-identity-01.md)
diff --git a/articles/python/index.yml b/articles/python/index.yml
@@ -35,7 +35,7 @@ landingContent:
       - linkListType: deploy
         links:
           - text: Flask using Visual Studio Code
-            url: tutorial-deploy-app-service-on-linux-01.md     
+            url: ./configure-python-web-app-local-environment.md
           - text: Flask using CLI
             url: /azure/app-service/quickstart-python?toc=/azure/developer/python/toc.json&bc=/azure/developer/breadcrumb/toc.json
           - text: Python (Django or Flask) + PostgreSQL
@@ -95,4 +95,4 @@ landingContent:
           - text: Windows Subsystem for Linux (WSL)
             url: /windows/wsl/install-win10
           - text: Visual Studio (for Python/C++ development)
-            url: /visualstudio/python/installation
+            url: /visualstudio/python/installation
diff --git a/articles/python/tutorial-python-managed-identity-01.md b/articles/python/tutorial-python-managed-identity-01.md
@@ -20,7 +20,7 @@ Each article in the tutorial covers a part or service shown in the service diagr
 
 ## How managed identity is used
 
-Managed identity provides an identity for your app so that it can connect to Azure resources without the need to use a secret key or other application secret. Internally, Azure knows the identity of your app and what resources it's allowed to connect to. Managed identity is the recommended approach to authenticate an app in Azure when using the Azure SDK for Python as is shown in this tutorial. For more information about authentication in Azure with Python, see [How to authenticate Python apps to Azure services using the Azure SDK for Python](/azure/developer/python/sdk/authentication-overview). 
+Managed identity provides an identity for your app so that it can connect to Azure resources without the need to use a secret key or other application secret. Internally, Azure knows the identity of your app and what resources it's allowed to connect to. Managed identity is the recommended approach to authenticate an app in Azure when using the Azure SDK for Python as is shown in this tutorial. For more information about authentication in Azure with Python, see [How to authenticate Python apps to Azure services using the Azure SDK for Python](./sdk/authentication-overview.md). 
 
 The sample Python app code doesn't change between the local development and Azure-hosted environments. Using the same code is possible because the [DefaultAzureCredential](/python/api/azure-identity/azure.identity.defaultazurecredential) is used, which handles both authentication scenarios as shown in the following diagram.
 
@@ -101,4 +101,4 @@ When deployed, restaurants and review data are stored in Azure Database for Post
 ## Next step
 
 > [!div class="nextstepaction"]
-> [Run the web app locally >>>](./tutorial-python-managed-identity-02.md)
+> [Run the web app locally >>>](./tutorial-python-managed-identity-02.md)
diff --git a/articles/python/tutorial-python-managed-identity-02.md b/articles/python/tutorial-python-managed-identity-02.md
diff --git a/articles/python/tutorial-python-managed-identity-05.md b/articles/python/tutorial-python-managed-identity-05.md
