updated based on feedback

Author: ms-johnalex

articles/ai-foundry/how-to/develop/get-started-projects-vs-code.md

@@ -8,7 +8,7 @@ content_well_notification:
   - AI-contribution
 ai-usage: ai-assisted
 ms.topic: how-to
-ms.date: 09/05/2025
+ms.date: 09/09/2025
 ms.reviewer: erichen
 ms.author: johalexander
 author: ms-johnalex
@@ -138,18 +138,18 @@ You can create a new Azure AI Foundry project from the Azure AI Foundry Extensio
 
 1. Select the **plus** icon next to **Resources** in the **Resources** section of the Azure AI Foundry Extension view.
 
-You can either create a new resource group or select an existing one.
-- To create a new resource group:
+    You can either create a new resource group or select an existing one.
+1. To create a new resource group:
     1. In the top center, select **Create new resource group** and press Enter.
 
     :::image type="content" source="../../media/how-to/get-started-projects-vs-code/select-resource-group.png" alt-text="Screenshot of the Choose resource group dropdown with the Create new resource group item highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/select-resource-group.png":::
-    
-    2. In the top center, enter the Azure Resource Group name to use in the **Enter new resource group** textbox and press Enter.
 
-    3. In the top center, select the location you want to use from the list of available locations and press Enter.
+    1. In the top center, enter the Azure Resource Group name to use in the **Enter new resource group** textbox and press Enter.
 
-- To use an existing resource group:
-    1. In the top center, select the resource group you want to use from the list of available resource groups and press Enter.
+    1. In the top center, select the location you want to use from the list of available locations and press Enter.
+
+1. To use an existing resource group:
+    - In the top center, select the resource group you want to use from the list of available resource groups and press Enter.
 
 1. In the top center, enter the Azure AI Foundry Project name to use in the **Enter project name** textbox and press Enter.
 

articles/ai-foundry/how-to/develop/vs-code-agents.md

@@ -129,14 +129,14 @@ Add a tool to the AI Agent with the following steps:
 1. After entering the required information, select the **Upload and save** button in the bottom-left corner.
  
 > [!NOTE]
-> When you add a tool, you can also add any new assets, it needs. For example, if you add a File Search tool, you can use an existing vector store asset or make a new asset for your vector store to host your uploaded files.
+> When you add a tool, you can also add any new assets it needs. For example, if you add a File Search tool, you can use an existing vector store asset or make a new asset for your vector store to host your uploaded files.
 
 #### Add an existing MCP Server tool to the AI Agent
 
 You can bring multiple remote MCP servers by adding them as tools. For each tool, you need to provide a unique `Server Label` value within the same agent and a `Server URL` value that points to the remote MCP server.
 
 > [!WARNING]
-> The remote MCP servers that you decide to use with the MCP tool described in this article were created by third parties, not Microsoft. Microsoft hasn't tested or verified these servers. For more information, see [Considerations for using non-Microsoft services and server](/azure/ai-foundry/agents/how-to/tools/model-context-protocol?branch=pr-en-us-6966#considerations-for-using-non-microsoft-services-and-servers)
+> The remote MCP servers that you decide to use with the MCP tool described in this article were created by third parties, not Microsoft. Microsoft hasn't tested or verified these servers. For more information, see [Considerations for using non-Microsoft services and server](/azure/ai-foundry/agents/how-to/tools/model-context-protocol?branch=pr-en-us-6966#considerations-for-using-non-microsoft-services-and-servers).
 
 To add an existing MCP Server tool to your AI Agent, follow these steps:
 
@@ -156,7 +156,7 @@ To add an existing MCP Server tool to your AI Agent, follow these steps:
     :::image type="content" source="../../media/how-to/get-started-projects-vs-code/agent-select-mcp-tool.png" alt-text="Screenshot of the MCP Server tool dialog box with the 'Allowed tools' dropdown highlighted." lightbox="../../media/how-to/get-started-projects-vs-code/agent-select-mcp-tool.png":::
 
     > [!WARNING]
-    > When you add an allowed tool, you can also pass a set of headers that the MCP server requires. Currently, there is an  issue when running an agent with MCP server that requires authentication in agent playground. https://github.com/microsoft/ai-foundry-for-vscode/issues/150
+    > When you add an allowed tool, you can also pass a set of headers that the MCP server requires. Currently, there is an issue when running an agent with MCP server that requires authentication in agent playground. For more information about this issue: https://github.com/microsoft/ai-foundry-for-vscode/issues/150
 
 1. After entering the required information, select the **Create tool** button in the bottom-left corner.