Visitar URL original
docs: document optimization disk recommendation summary by WeAreResilience · Pull Request #3936 · microsoft/mcp · GitHub
Skip to content

docs: document optimization disk recommendation summary - #3936

Open
David Billiot (WeAreResilience) wants to merge 1 commit into
microsoft:mainfrom
WeAreResilience:fix-3935
Open

David Billiot (WeAreResilience) wants to merge 1 commit into
microsoft:mainfrom
WeAreResilience:fix-3935

Conversation

@WeAreResilience

@WeAreResilience David Billiot (WeAreResilience) commented Oct 13, 2026 •

Copy link
Copy Markdown

Fixes #3935

PR #3899 added a diskRecommendationSummary output to optimization recommendation list, but the docs didn't describe it, and the Optimization toolset had no README entry.

Changes (docs only, all under servers/Azure.Mcp.Server/):

  • docs/azmcp-commands.md: note under optimization recommendation list that unattached-disk recommendations are returned as one diskRecommendationSummary object (message, unattachedDiskCount, subscriptionIds, actionUrl) instead of individual rows. Field names match tools/Azure.Mcp.Tools.Optimization/src/Models/DiskRecommendationSummary.cs on current main.
  • docs/e2eTestPrompts.md: add an optimization_recommendation_list prompt about unattached disks.
  • README.md: add an "Azure Optimization" example-prompt section and an entry in "Complete List of Supported Azure Services", placed alphabetically.

No code changes. Rebased onto current main on Nov 11; merges cleanly.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).
There may be pipelines that require an authorized user to comment /azp run to run.

@github-actions

Copy link
Copy Markdown
Contributor

Thank you for your contribution David Billiot (@WeAreResilience)! We will review the pull request and get back to you soon.

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.

🟢 Approval recommended

The documentation accurately reflects the existing implementation and fulfills the linked issue.

0 open findings

What changed in this PR

Closes #3935 by documenting Azure Optimization’s unattached-disk recommendation summary and improving tool discovery.

Changes:

  • Documents the diskRecommendationSummary response.
  • Adds an unattached-disk e2e prompt.
  • Adds Azure Optimization examples and service-list coverage.
File Description
servers/​Azure.Mcp.Server/​README.md Adds Optimization discovery content.
servers/​Azure.Mcp.Server/​docs/​e2eTestPrompts.md Adds summary-focused test prompt.
servers/​Azure.Mcp.Server/​docs/​azmcp-commands.md Documents the summary response contract.

🧠 Review effort: Balanced


💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@WeAreResilience

Copy link
Copy Markdown
Author

Gentle ping on this docs change: it's ready for review whenever someone has a moment.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Doc Gap] Documentation missing for Optimization tool's new disk-recommendation summary and Advisor-to-"cost optimization" terminology cha

2 participants