Skip to content

Commit 044cd29

Browse files
committed
minor tweaks to style and formatting
1 parent 17506fb commit 044cd29

5 files changed

Lines changed: 25 additions & 31 deletions

File tree

learn-pr/wwl-azure/manage-ado-mcp-server/includes/10-inspect-build-logs.md

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -49,13 +49,12 @@ Over repeated incidents, this approach creates a strong troubleshooting discipli
4949

5050
To map with the earlier-described example scenario, here are a few sample prompt to illustrate how to use MCP-assisted prompting for those scenarios:
5151

52-
```
5352
- "Get all errors and warnings from the Test stage in build #4527."
5453
- "Summarize failures in the MyProject.Tests project from build #4527."
5554
- "Show me test instability patterns: which tests failed in build #4527 but passed in build #4526?"
5655
- "Extract dependency restore and NuGet feed errors from build #4527 Test stage."
5756
- "List all warnings in the Test stage that might indicate environment drift in build #4527."
58-
```
57+
5958

6059
These prompts narrow scope to the failing stage and test project, helping teams isolate whether the issue is environment-related, a true functional regression, or test instability.
6160

learn-pr/wwl-azure/manage-ado-mcp-server/includes/12-guided-exercise-manage-azure-devops-mcp-server.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,12 @@
11
> [!IMPORTANT]
2-
> To complete this exercise, you need
3-
- An active GitHub account,
4-
- An active GitHub Copilot subscription,
5-
- Access to an Azure DevOps project
6-
- A Visual Studio Code environment.
2+
> To complete this exercise, you need:
3+
> - An active GitHub account
4+
> - An active GitHub Copilot subscription
5+
> - Access to an Azure DevOps project
6+
> - A Visual Studio Code environment
77
88
This exercise provides a comprehensive experience of using Azure DevOps MCP Server in Visual Studio Code. You use GitHub Copilot AI-assistance. Throughout the exercise, you handle several common DevOps team tasks, such as interact with Azure Boards work items, retrieve and trigger pipeline runs. Next, you learn how to use MCP to inspect ADO logs and apply Azure DevOps Security guidelines when using MCP.
99

10-
By the end of this lab, you are able to:
11-
1210
> [!IMPORTANT]
1311
> The focus of this exercise is on the integration of both DevOps platforms, without using actual application code.
1412

learn-pr/wwl-azure/manage-ado-mcp-server/includes/14-summary.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@ In this module, you learned how to use Azure DevOps MCP Server with GitHub Copil
22

33
The module followed an end-to-end progression from setup through execution:
44

5-
1. understanding the MCP interaction model
6-
2. installing and validating tooling in Visual Studio Code
7-
3. authenticating and reviewing payloads safely
8-
4. gathering context before changing artifacts
9-
5. creating, linking, and updating work items
10-
6. managing pull request collaboration workflows
11-
7. triggering and monitoring pipelines
12-
8. retrieving and interpreting logs for troubleshooting
13-
9. applying governance guardrails for sustainable adoption
5+
1. Understanding the MCP interaction model
6+
2. Installing and validating tooling in Visual Studio Code
7+
3. Authenticating and reviewing payloads safely
8+
4. Gathering context before changing artifacts
9+
5. Creating, linking, and updating work items
10+
6. Managing pull request collaboration workflows
11+
7. Triggering and monitoring pipelines
12+
8. Retrieving and interpreting logs for troubleshooting
13+
9. Applying governance guardrails for sustainable adoption
1414

1515
## Key takeaways
1616

learn-pr/wwl-azure/manage-ado-mcp-server/includes/2-understand-azure-devops-mcp-server.md

Lines changed: 9 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@ Azure DevOps MCP Server provides a practical translation layer between conversat
22

33
Before diving into the details of the Azure DevOps MCP Server capabilities, let's start with describing what MCP actually is?
44

5-
## What is MCP
5+
## What is MCP?
66

77
The Model Context Protocol (MCP) is an open standard developed by Anthropic for enabling AI systems to safely and transparently interact with external tools, data sources, and services. At its core, MCP defines a structured communication layer between AI models (like GitHub Copilot, Anthropic's Claude and other) and the systems they need to access; whether those are databases, APIs, file systems, or specialized platforms like Azure DevOps.
88

@@ -27,13 +27,10 @@ In a business context, MCP addresses a fundamental challenge: teams increasingly
2727

2828
MCP enables several practical outcomes:
2929

30-
**Accelerated Workflow Automation**: DevOps (and wider business) Teams can describe tasks using natural language and have AI safely execute them across multiple systems. A DevOps engineer might ask an AI assistant to "create a bug, assign it to the on-call engineer, and link it to the current incident," and MCP ensures each step is transparent and auditable.
31-
32-
**Reduced Integration Overhead**: Instead of building connectors for every AI platform and every business system, organizations implement MCP once and gain compatibility across tools. This lowers the total cost of custom integration work.
33-
34-
**Improved Governance**: MCP's transparent execution model makes it easier to enforce least-privilege access, log operations for compliance, and audit AI-driven changes to critical systems. This is essential for regulated industries and enterprises managing sensitive data.
35-
36-
**Vendor Neutrality**: Because MCP is open, teams are not locked into a single AI provider or tool vendor. They can migrate assistants or add new tools without rewriting integrations.
30+
- **Accelerated Workflow Automation**: DevOps (and wider business) Teams can describe tasks using natural language and have AI safely execute them across multiple systems. A DevOps engineer might ask an AI assistant to "create a bug, assign it to the on-call engineer, and link it to the current incident," and MCP ensures each step is transparent and auditable.
31+
- **Reduced Integration Overhead**: Instead of building connectors for every AI platform and every business system, organizations implement MCP once and gain compatibility across tools. This lowers the total cost of custom integration work.
32+
- **Improved Governance**: MCP's transparent execution model makes it easier to enforce least-privilege access, log operations for compliance, and audit AI-driven changes to critical systems. This is essential for regulated industries and enterprises managing sensitive data.
33+
- **Vendor Neutrality**: Because MCP is open, teams are not locked into a single AI provider or tool vendor. They can migrate assistants or add new tools without rewriting integrations.
3734

3835
In practice, MCP enables enterprises to deploy AI as a workflow accelerant while maintaining the security, auditability, and control that business-critical operations require. It shifts the conversation from "How do we safely let AI interact with our systems?" to "How do we standardize that interaction so it scales?"
3936

@@ -146,10 +143,10 @@ Understanding this categorization helps you craft better prompts. If your reques
146143

147144
Natural language is flexible, but operational systems still expect specific input. This is where you can craft 'better' prompts, which usually include:
148145

149-
- project or repository scope
150-
- object type (bug, PR, build, pipeline)
151-
- clear action verb (list, create, update, link, run)
152-
- optional constraints (state, iteration, assignee, branch)
146+
- Project or repository scope
147+
- Object type (bug, PR, build, pipeline)
148+
- Clear action verb (list, create, update, link, run)
149+
- Optional constraints (state, iteration, assignee, branch)
153150

154151
A more generic prompt (question) can still work, but often results in more follow-up questions or broad result sets. A scoped prompt lowers risk and improves speed. Since Generative AI communication between the prompt input and response using Large Language Models (LLMs) relies on tokens, it might also impact cost to have more focused prompts, resulting in a more focused prompt response.
155152

learn-pr/wwl-azure/manage-ado-mcp-server/includes/6-create-link-work-items.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ Even strong first prompts may require enrichment. Use follow-up actions to impro
2525

2626
- Add reproduction steps in discussion comments
2727
- Assign ownership explicitly
28-
- Tag by area or platform (for example, `Android` or 'WindowsOS')
28+
- Tag by area or platform (for example, `Android` or `WindowsOS`)
2929
- Place the item in the correct sprint
3030

3131
These details support triage, capacity planning, and faster root-cause analysis later.

0 commit comments

Comments
 (0)