Skip to content

Add manual testing instructions (#592)#3004

Open
LarryOsterman wants to merge 3 commits into
microsoft:mainfrom
LarryOsterman:larryosterman-add-manual-testing-instructions
Open

Add manual testing instructions (#592)#3004
LarryOsterman wants to merge 3 commits into
microsoft:mainfrom
LarryOsterman:larryosterman-add-manual-testing-instructions

Conversation

@LarryOsterman

@LarryOsterman LarryOsterman commented Jul 7, 2026

Copy link
Copy Markdown
Member

What does this PR do?

Fixes issue #592

[Add additional context, screenshots, or information that helps reviewers]

GitHub issue number?

#592

Pre-merge Checklist

  • Required for All PRs
    • Read contribution guidelines
    • PR title clearly describes the change
    • Commit history is clean with descriptive messages (cleanup guide)
    • Added comprehensive tests for new/modified functionality
    • Created a changelog entry if the change falls among the following: new feature, bug fix, UI/UX update, breaking change, or updated dependencies. Follow the changelog entry guide
  • For MCP tool changes:
    • One tool per PR: This PR adds or modifies only one MCP tool for faster review cycles
    • Updated servers/Azure.Mcp.Server/README.md and/or servers/Fabric.Mcp.Server/README.md documentation
    • Validate README.md changes running the script ./eng/scripts/Process-PackageReadMe.ps1. See Package README
    • For new or modified tool descriptions, ran ToolDescriptionEvaluator and obtained a score of 0.4 or more and a top 3 ranking for all related test prompts
    • For tools with new names, including new tools or renamed tools, update consolidated-tools.json
    • For renamed tools, follow the Tool Rename Checklist and tag the PR with the breaking-change label
    • For new tools associated with Azure services or publicly available tools/APIs/products, add URL to documentation in the PR description
  • Extra steps for Azure MCP Server tool changes:
    • Updated command list in servers/Azure.Mcp.Server/docs/azmcp-commands.md
    • Ran ./eng/scripts/Update-AzCommandsMetadata.ps1 to update tool metadata in azmcp-commands.md (required for CI)
    • Updated test prompts in servers/Azure.Mcp.Server/docs/e2eTestPrompts.md
    • 👉 For Community (non-Microsoft team member) PRs:
      • Security review: Reviewed code for security vulnerabilities, malicious code, or suspicious activities before running tests (crypto mining, spam, data exfiltration, etc.)
      • Manual tests run: added comment /azp run mcp - pullrequest - live to run Live Test Pipeline

LarryOsterman and others added 2 commits July 2, 2026 14:05
Create docs/manual-testing.md with comprehensive manual testing
instructions including environment setup, server configuration,
test execution steps for all/namespace and consolidated modes,
validation criteria, and result reporting guidelines.

Reference the new guide from the End-to-end Tests section in
CONTRIBUTING.md.

Fixes microsoft#592

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new documentation page that explains how to run manual end-to-end validation of Azure MCP tool invocation, and links to it from the contribution guide so contributors can find a single, consistent set of steps.

Changes:

  • Added docs/manual-testing.md with environment setup, prompt execution steps, and validation/reporting criteria.
  • Linked the new manual testing guide from the “End-to-end Tests” section in CONTRIBUTING.md.

Invoking Livetests

Copilot submitted PRs are not trustworthy by default. Users with write access to the repo need to validate the contents of this PR before leaving a comment with the text /azp run mcp - pullrequest - live. This will trigger the necessary livetest workflows to complete required validation.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 1 comment.

File Description
docs/manual-testing.md Introduces a manual testing guide for Azure MCP Server tool invocation validation.
CONTRIBUTING.md Adds a cross-reference to the manual testing guide from the e2e testing section.

Comment thread docs/manual-testing.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Untriaged

Development

Successfully merging this pull request may close these issues.

2 participants