Skip to content

[Resource] az deployment what-if: Point users to Deployment Stacks What-If in the noise notice - #33943

Merged
Cooper Cox (coopercox-ms) merged 1 commit into
Azure:devfrom
torreymicrosoft:torreyt/whatif-stacks-notice
Aug 21, 2026
Merged

[Resource] az deployment what-if: Point users to Deployment Stacks What-If in the noise notice#33943
Cooper Cox (coopercox-ms) merged 1 commit into
Azure:devfrom
torreymicrosoft:torreyt/whatif-stacks-notice

Conversation

@torreymicrosoft

@torreymicrosoft Torrey Trahanovsky (torreymicrosoft) commented Aug 20, 2026

Copy link
Copy Markdown
Member

Related command

az deployment group what-if, az deployment sub what-if, az deployment mg what-if, az deployment tenant what-if (and the what-if preview shown by --confirm-with-what-if / -c on az deployment ... create).

Description

What-if for Azure Deployment Stacks is now generally available in all regions. Stacks What-if filters out noise by diffing against a baseline recorded when the stack was deployed, so it does not carry the false-positive caveat that template deployment what-if still has.

Today the very first thing a customer sees when they run template deployment what-if is a notice telling them the result may be wrong, and the only next step it offers is filing an issue. This PR replaces that call to action with the one that actually solves the problem for them: move to Stacks What-if.

Exact verbiage added

NOTICE! - Want to get What-if without noise? Move to Deployment Stacks What-If https://aka.ms/stackswhatifGA

Exact verbiage removed

You can help us improve the accuracy of the result by opening an issue here: https://aka.ms/WhatIfIssues

Before

Note: The result may contain false positive predictions (noise).
You can help us improve the accuracy of the result by opening an issue here: https://aka.ms/WhatIfIssues

After

Note: The result may contain false positive predictions (noise).
NOTICE! - Want to get What-if without noise? Move to Deployment Stacks What-If https://aka.ms/stackswhatifGA

https:// is included on the link (the short link itself is aka.ms/stackswhatifGA) so terminals render it as a hyperlink.

Scope / risk

  • The only change is the string literal in _format_noise_notice in src/azure-cli/azure/cli/command_modules/resource/_formatters.py, which is reached solely through format_what_if_operation_result for template deployment what-if.
  • Deployment Stacks what-if output is produced by DeploymentStacksWhatIfResultFormatter in _stacks_formatters.py and is deliberately not touched, so customers who already moved to stacks are not told to move to stacks.
  • https://aka.ms/WhatIfIssues had no other references in src/, so nothing is left orphaned by its removal.
  • No test asserts the notice text. test_resource_changes_stats asserts result.endswith(...) against the trailing resource-changes stats line, which is unaffected because the notice is emitted at the top of the output.
  • The new line is 111 characters, within the 120-character limit configured in both pylintrc and .flake8.

…at-If in noise notice

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings August 20, 2026 23:17
@azure-client-tools-bot-prd

Copy link
Copy Markdown

Hi Torrey Trahanovsky (@torreymicrosoft),
Since the current milestone time is less than 7 days, this pr may not catch up with this release.

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
There may be pipelines that require an authorized user to comment /azp run to run.

@yonzhan

Copy link
Copy Markdown
Collaborator

Resource

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

Updates the template deployment what-if output in the Resource command module to provide a clear next-step for users who want a noise-free what-if experience, by pointing them to the now-GA Deployment Stacks What-If.

Changes:

  • Extends the existing “noise/false positives” notice in _format_noise_notice to include a new line advertising Deployment Stacks What-If with a hyperlink-friendly https:// URL.

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

@microsoft-github-policy-service microsoft-github-policy-service Bot added Auto-Assign Auto assign by bot ARM az resource/group/lock/tag/deployment/policy/managementapp/account management-group act-identity-squad labels Aug 20, 2026
@a0x1ab

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 3 pipeline(s).

@coopercox-ms Cooper Cox (coopercox-ms) changed the title [Resource] az deployment what-if: point users to Deployment Stacks What-If in the noise notice [Resource] az deployment what-if: point users to Deployment Stacks What-If in the noise notice Aug 21, 2026
@coopercox-ms

Copy link
Copy Markdown
Member

/azp run

@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 3 pipeline(s).

@coopercox-ms Cooper Cox (coopercox-ms) changed the title [Resource] az deployment what-if: point users to Deployment Stacks What-If in the noise notice [Resource] az deployment what-if: Point users to Deployment Stacks What-If in the noise notice Aug 21, 2026

@notyashhh Yash (notyashhh) left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Looks good

@coopercox-ms
Cooper Cox (coopercox-ms) merged commit 42822b6 into Azure:dev Aug 21, 2026
61 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

act-identity-squad ARM az resource/group/lock/tag/deployment/policy/managementapp/account management-group Auto-Assign Auto assign by bot

Projects

None yet

Development

Successfully merging this pull request may close these issues.

7 participants