fix warnings

gracekulin_micrsoft · gracekulin_micrsoft · commit 173f5da8f12d · 2023-04-27T13:08:33.000-07:00
diff --git a/articles/azure-developer-cli/azd-schema.md b/articles/azure-developer-cli/azd-schema.md
@@ -11,7 +11,7 @@ ms.service: azure-dev-cli
 
 # Azure Developer CLI's azure.yaml schema
 
-[`azd` templates](./overview.md#azure-developer-cli-templates) are sample repositories that include app code, tools, and infrastructure code. You can use these templates to create your own solutions using Azure Developer CLI (`azd`). The [azure.yaml](https://aka.ms/azure.yaml.json) schema defines and describes the apps and types of Azure resources that are included in these templates.
+[`azd` templates](./more-azd-info.md#azure-developer-cli-templates) are sample repositories that include app code, tools, and infrastructure code. You can use these templates to create your own solutions using Azure Developer CLI (`azd`). The [azure.yaml](https://aka.ms/azure.yaml.json) schema defines and describes the apps and types of Azure resources that are included in these templates.
 
 ## Sample
 
diff --git a/articles/azure-developer-cli/configure-devops-pipeline.md b/articles/azure-developer-cli/configure-devops-pipeline.md
@@ -11,7 +11,7 @@ ms.custom: devx-track-azdevcli
 
 # Configure a pipeline and push updates (preview)
 
-In this article, you'll push [Todo Application with Node.js and Azure Cosmos DB for MongoDB](https://github.com/azure-samples/todo-nodejs-mongo) template changes through GitHub Actions or Azure DevOps via Azure Developer CLI (azd). However, you can apply the principles you learn in this article to any of the [Azure Developer CLI templates](overview.md#azure-developer-cli-templates).
+In this article, you'll push [Todo Application with Node.js and Azure Cosmos DB for MongoDB](https://github.com/azure-samples/todo-nodejs-mongo) template changes through GitHub Actions or Azure DevOps via Azure Developer CLI (azd). However, you can apply the principles you learn in this article to any of the [Azure Developer CLI templates](./more-azd-info.md#azure-developer-cli-templates).
 
 ## Prerequisites
 
diff --git a/articles/azure-developer-cli/includes/debug-visual-studio-code.md b/articles/azure-developer-cli/includes/debug-visual-studio-code.md
@@ -6,7 +6,7 @@ ms.date: 10/31/2022
 ms.author: alexwolf
 ---
 
-Run and debug apps on your local machine using the [Visual Studio Code](https://code.visualstudio.com/docs) extension for Azure Developer CLI (`azd`). In this guide, you'll use the [Todo Application with Node.js and Azure Cosmos DB for MongoDB](https://github.com/azure-samples/todo-nodejs-mongo) template. You can apply the principles you learn in this article to any of the [Azure Developer CLI templates](../overview.md#azure-developer-cli-templates).
+Run and debug apps on your local machine using the [Visual Studio Code](https://code.visualstudio.com/docs) extension for Azure Developer CLI (`azd`). In this guide, you'll use the [Todo Application with Node.js and Azure Cosmos DB for MongoDB](https://github.com/azure-samples/todo-nodejs-mongo) template. You can apply the principles you learn in this article to any of the [Azure Developer CLI templates](../more-azd-info.md#azure-developer-cli-templates).
 
 ## Prerequisites
 
diff --git a/articles/azure-developer-cli/includes/debug-visual-studio.md b/articles/azure-developer-cli/includes/debug-visual-studio.md
@@ -6,7 +6,7 @@ ms.date: 08/10/2022
 ms.author: alexwolf
 ---
 
-Run and debug apps built on your local machine using [Visual Studio](/visualstudio/azure) and Azure Developer CLI (`azd`). In this guide, you'll use the [Todo application with C# and Azure Cosmos DB for MongoDB](https://github.com/Azure-Samples/todo-csharp-cosmos-sql) template. You can apply the principles you learn in this article to any of the [Azure Developer CLI templates](../overview.md#azure-developer-cli-templates).
+Run and debug apps built on your local machine using [Visual Studio](/visualstudio/azure) and Azure Developer CLI (`azd`). In this guide, you'll use the [Todo application with C# and Azure Cosmos DB for MongoDB](https://github.com/Azure-Samples/todo-csharp-cosmos-sql) template. You can apply the principles you learn in this article to any of the [Azure Developer CLI templates](../more-azd-info.md#azure-developer-cli-templates).
 
 ## Prerequisites
 
diff --git a/articles/azure-developer-cli/install-azd.md b/articles/azure-developer-cli/install-azd.md
@@ -13,7 +13,7 @@ ms.service: azure-dev-cli
 
 Welcome to the Azure Developer CLI (`azd`)! Let's get started with installing and learning how to run the `azd`.
 
-Start by selecting your development environment. For more information about the pros and cons of the different development environment choices, see [Azure Developer CLI (azd) supported environments](overview.md#supported-development-environments).
+Start by selecting your development environment. For more information about the pros and cons of the different development environment choices, see [Azure Developer CLI (azd) supported environments](more-azd-info.md#supported-development-environments).
 
 
 ## [Local install](#tab/localinstall)
diff --git a/articles/azure-developer-cli/make-azd-compatible.md b/articles/azure-developer-cli/make-azd-compatible.md
@@ -13,7 +13,7 @@ zone_pivot_groups: make-azure-developer-cli-compatible-set
 
 # Make your project compatible with Azure Developer CLI (preview)
 
-Azure Developer CLI (`azd`) enables developers to create apps from [templates](./azd-templates.md) stored in GitHub repositories. Microsoft provides [several templates](overview.md?branch=pr-en-us-3070&tabs=nodejs#azure-developer-cli-templates) to get you started. In this article, you learn how to enable your own project as a template.
+Azure Developer CLI (`azd`) enables developers to create apps from [templates](./azd-templates.md) stored in GitHub repositories. Microsoft provides [several templates](./azd-templates.md#choose-a-template) to get you started. In this article, you learn how to enable your own project as a template.
 
 ## Understand the `azd` architecture
 
diff --git a/articles/azure-developer-cli/more-azd-info.md b/articles/azure-developer-cli/more-azd-info.md
@@ -1,6 +1,6 @@
 ---
 title: Other things to know about AZD
-description: Overview of the features and capabilities of the Azure Developer CLI that helps developers be more productive when building and deploying apps to Azure.
+description: Details about the Azure Developer CLI's template structure and supported development environments, hosts, and programming languages.
 author: gkulin
 ms.author: gracekulin
 ms.date: 4/27/2023
@@ -15,6 +15,14 @@ ms.custom: devx-track-azdevcli, devx-track-azurecli
 
 > [!VIDEO https://www.youtube.com/embed/VTk-FhJyo7s]
 
+## Azure Developer CLI templates
+
+The Azure Developer CLI works alongside [idiomatic application templates](./azd-templates.md) that include the scaffolding for monitoring and CI/CD for your application. We provide `azd` templates in four supported languages. Each template uses best practices and includes:
+
+- Application code
+- Infra-as-code files (Bicep or Terraform) needed to provision the Azure resources
+- An `azure.yaml` file that describes your application.
+
 ## Supported development environments
 
 You can run any `azd` template, in one of the following supported development environments:
@@ -48,7 +56,7 @@ Currently supported/planned languages:
 | .NET     | Yes         |
 | Java     | Yes         |
 
-# Next Steps
+## Next Steps
 - Get started by [installing Azure Developer CLI](./install-azd.md).
 - [Walk through our quickstart](./get-started.md) to see Azure Developer CLI in action.
   
diff --git a/articles/azure-developer-cli/overview.md b/articles/azure-developer-cli/overview.md
@@ -13,7 +13,7 @@ ms.custom: devx-track-azdevcli, devx-track-azurecli
 
 Azure Developer CLI (`azd`) is an open-source tool that accelerates the time it takes for you to get started on Azure. The CLI provides best practice, developer-friendly commands that map to key stages in your workflow, whether you’re working in the terminal, your editor or integrated development environment (IDE), or DevOps.
 
-You can use `azd` with [extensible azd templates](#azure-developer-cli-templates) that include everything you need to get an application up and running in Azure. These templates include reusable infrastructure as code assets and application code that can be ripped out and replaced with your own app code.
+You can use `azd` with [extensible azd templates](./more-azd-info.md#azure-developer-cli-templates) that include everything you need to get an application up and running in Azure. These templates include reusable infrastructure as code assets and application code that can be ripped out and replaced with your own app code.
 
 ## Typical `azd` workflow
 
