Formatting

Author: bobtabor-msft

articles/github-copilot-azure/get-started.md

@@ -60,125 +60,125 @@ You may need to enable agent mode.
 
 1. In Visual Studio Code, open **Settings** using the **Manage** icon (gear).
 
-  :::image type="content" source="media/get-started/vscode-settings.png" alt-text="Screenshot that shows the VSCode settings menu by selecting the Manage button.":::
+   :::image type="content" source="media/get-started/vscode-settings.png" alt-text="Screenshot that shows the VSCode settings menu by selecting the Manage button.":::
 
 
 1. In the Settings' Search bar, search for `chat.agent.enabled`.
 1. Check the box next to **Chat > Agent: Enabled**.
 
-  :::image type="content" source="media/get-started/chat-agent-enabled.png" alt-text="Screenshot that shows the settings dialog with settings filtered to chat.agent.enabled.":::
+   :::image type="content" source="media/get-started/chat-agent-enabled.png" alt-text="Screenshot that shows the settings dialog with settings filtered to chat.agent.enabled.":::
 
 ### Use agent mode
 
 There are three modes: ask (default), edit and agent. To use agent mode, you must select it in the chat pane.
 
 1. If the Chat window is not already open, make sure it's open by either selecting the **Toggle Chat** button in the menu bar, or select the dropdown next to the **Toggle Chat** button and select **Open Chat (Ctrl+Alt+I)**.
 
-  :::image type="content" source="media/get-started/open-chat.png" alt-text="Screenshot that shows the Toggle Chat menu open and selecting the the Open Chat menu option.":::
+   :::image type="content" source="media/get-started/open-chat.png" alt-text="Screenshot that shows the Toggle Chat menu open and selecting the the Open Chat menu option.":::
 
 1. In the chat pane, in the chat prompt, select the mode dropdown and choose **Agent**.
 
-  :::image type="content" source="media/get-started/mode-agent.png" alt-text="Screenshot that shows the pop-up menu in the Chat box with Agent selected.":::
+   :::image type="content" source="media/get-started/mode-agent.png" alt-text="Screenshot that shows the pop-up menu in the Chat box with Agent selected.":::
 
 1. The chat pane will confirm that you are currently in agent mode.
 
-  :::image type="content" source="media/get-started/agent-mode-confirmation.png" alt-text="Screenshot that shows the chat pane confirming you are now in agent mode.":::
+   :::image type="content" source="media/get-started/agent-mode-confirmation.png" alt-text="Screenshot that shows the chat pane confirming you are now in agent mode.":::
 
 1. To see agent mode working, use the following prompt:
 
-  ```
-  What are your tools?
-  ```
+   ```
+   What are your tools?
+   ```
 
   The completion response will display a list of GitHub Copilot for Azure specific tools available to GitHub Copilot. The response provides a good overview of the kinds of functionality now available to you:
 
-  ```
-I can assist you with various tasks using a range of tools. Here are the main tools I have available:
-
-1. Search and Navigation
-  - Semantic search for code or documentation
-  - File search using glob patterns
-  - Text search (grep)
-  - List directory contents
-  - Read file contents
-  - List code usages/references
-
-2. Code Editing and Analysis
-  - Insert edits into files
-  - Get errors in code files
-  - Test search (find test files)
-
-3. Terminal and Git Operations
-  - Run commands in terminal
-  - Get terminal output
-  - Get Git diffs and changed files
-
-4. Project Creation
-  - Create new workspaces
-  - Get project setup information
-  - Install VS Code extensions
-  - Create new Jupyter Notebooks
-
-5. Web and API Tools
-  - Fetch webpage content
-  - Get VS Code API references
+   ```
+   I can assist you with various tasks using a range of tools. Here are the main tools I have available:
+
+   1. Search and Navigation
+     - Semantic search for code or documentation
+     - File search using glob patterns
+     - Text search (grep)
+     - List directory contents
+     - Read file contents
+     - List code usages/references
+
+   2. Code Editing and Analysis
+     - Insert edits into files
+     - Get errors in code files
+     - Test search (find test files)
+
+   3. Terminal and Git Operations
+     - Run commands in terminal
+     - Get terminal output
+     - Get Git diffs and changed files
+
+   4. Project Creation
+     - Create new workspaces
+     - Get project setup information
+     - Install VS Code extensions
+     - Create new Jupyter Notebooks
+
+   5. Web and API Tools
+     - Fetch webpage content
+     - Get VS Code API references
   
-6. Azure Tools
-  - Azure development best practices
-  - Microsoft Learn documentation
-  - Azure resource management
-  - Azure authentication tools
-  - AI model deployment and management
-  - Azure Bicep schemas
-  - Service configuration and deployment
-  - Azure Developer CLI tools
+   6. Azure Tools
+     - Azure development best practices
+     - Microsoft Learn documentation
+     - Azure resource management
+     - Azure authentication tools
+     - AI model deployment and management
+     - Azure Bicep schemas
+     - Service configuration and deployment
+     - Azure Developer CLI tools
+
+   Would you like me to explain any specific tool in more detail or help you with a particular task?
 
-Would you like me to explain any specific tool in more detail or help you with a particular task?
-
-  ```
+   ```
 
 
 1. The last entry, `Azure Developer CLI tools`, could be employed with the following prompt: 
 
-  ```
-What is the az command to list all my storage accounts ordered by location?
-  ```
+   ```
+   What is the az command to list all my storage accounts ordered by location?
+   ```
 
-The completion to that prompt might generate:
+   The completion to that prompt might generate:
 
-  ```
+   ```
 
-I'll help you generate the Azure CLI command to list all your storage accounts ordered by location. Let me use the Azure CLI generator tool to get the correct syntax for this command.
+   I'll help you generate the Azure CLI command to list all your storage accounts ordered by location. Let me use the Azure CLI generator tool to get the correct syntax for this command.
 
-To list all your storage accounts ordered by location in Azure, you can use the following Azure CLI command:
+   To list all your storage accounts ordered by location in Azure, you can use the following Azure CLI command:
 
-az storage account list --query "sort_by(@, &location)"
+   az storage account list --query "sort_by(@, &location)"
 
-This command will:
+   This command will:
 
-1. Retrieve all storage accounts you have access to in your Azure subscription
-2. Sort the results based on the location (Azure region) of each storage account
-3. Display the full details of each storage account in the sorted order
+   1. Retrieve all storage accounts you have access to in your Azure subscription
+   2. Sort the results based on the location (Azure region) of each storage account
+   3. Display the full details of each storage account in the sorted order
 
-If you'd prefer a more concise output focusing on specific fields, you could modify the query. For example, to show only the name and location in a table format:
+   If you'd prefer a more concise output focusing on specific fields, you could modify the query. For example, to show only the name and location in a table format:
 
-az storage account list --query "sort_by(@, &location)[].[name,location]" -o table
+   az storage account list --query "sort_by(@, &location)[].[name,location]" -o table
 
-Make sure you're logged into the Azure CLI before running this command. If you're not logged in yet, you can do so with az login.
+   Make sure you're logged into the Azure CLI before running this command. If you're not logged in yet, you can do so with az login.
 
-  ```
+   ```
 
 ### Enable and disable tools in agent mode
 
 You may want to disable or re-enable certain tools available by GitHub Copilot for Azure.
 
 1. Select the tool icon in the chat pane.
 
-  :::image type="content" source="media/get-started/tool-icon.png" alt-text="Screenshot of chat pane with highlight around the tool icon.":::
+   :::image type="content" source="media/get-started/tool-icon.png" alt-text="Screenshot of chat pane with highlight around the tool icon.":::
 
 1. Use the checkbox next to the list of tools to enable / disable tools (or groups of tools).
 
-  :::image type="content" source="media/get-started/tool-list.png" alt-text="Screenshot of the list of tools in Visual Studio Code.":::
+   :::image type="content" source="media/get-started/tool-list.png" alt-text="Screenshot of the list of tools in Visual Studio Code.":::
 
 
 ### Best practices for working in agent mode
@@ -187,7 +187,7 @@ To get better agentic results, consider the following best practices.
 
 - **When prompted, add the `copilot-instructions.md` file to your workspace.** 
 
-  :::image type="content" source="media/get-started/copilot-instructions.png" alt-text="Screenshot of the Visual Studio Code notification to add the copilot instructions file to the workspace.":::
+   :::image type="content" source="media/get-started/copilot-instructions.png" alt-text="Screenshot of the Visual Studio Code notification to add the copilot instructions file to the workspace.":::
 
 - **Keep your prompts as granular as possible.** Instead of a prompt like `Generate a Python web application and deploy it to Azure`, you should break that up into a dozen or so smaller prompts each with a smaller scope of responsibility.
 
@@ -197,9 +197,9 @@ To get better agentic results, consider the following best practices.
 
 - **Express your preferences.** If GitHub Copilot wants to perform an action and you would prefer it to take a *different* action, you can instruct it to do it your preferred way. For example, if it wants to create a folder to contain bicep files called `\.azure`, you could intervene and ask it to use a different folder with a prompt such as:
 
-  ```
-  Instead of naming the folder `.azure`, please name it `infra`
-  ```
+   ```
+   Instead of naming the folder `.azure`, please name it `infra`
+   ```
 
 
 ## Optional: Set your default tenant