About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
Summary:
The documentation demonstrates a moderate Windows bias. PowerShell examples and instructions are consistently presented before Azure CLI equivalents, and the output samples are shown in PowerShell syntax. The text output and programmatic evaluation sections use PowerShell as the primary example, with CLI examples following. There is a focus on PowerShell cmdlets and Windows-centric tools, with no mention of Linux-specific considerations or shell environments. However, Azure CLI examples are present throughout, and both PowerShell and CLI are covered in most sections.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples to avoid always presenting Windows/PowerShell first.
- Provide explicit Linux/macOS shell examples where relevant (e.g., bash, zsh), especially for scripting and environment setup.
- Include notes about cross-platform compatibility for both PowerShell (e.g., PowerShell Core on Linux/macOS) and Azure CLI.
- Ensure that output samples are shown in both PowerShell and CLI formats, or use CLI as the default where possible for cross-platform parity.
- Clarify that all commands work on Windows, Linux, and macOS, and mention any platform-specific caveats if they exist.
Create pull request
Flagged Code Snippets
New-AzResourceGroup `
-Name ExampleGroup `
-Location centralus
New-AzResourceGroupDeployment `
-ResourceGroupName ExampleGroup `
-TemplateFile "what-if-before.bicep"
New-AzResourceGroupDeployment `
-Whatif `
-ResourceGroupName ExampleGroup `
-TemplateFile "what-if-after.bicep"
$results = Get-AzResourceGroupDeploymentWhatIfResult `
-ResourceGroupName ExampleGroup `
--template-file "what-if-after.bicep"
New-AzResourceGroupDeployment `
-ResourceGroupName ExampleGroup `
-Confirm `
-TemplateFile "what-if-after.bicep"
Install-Module -Name Az -Force
foreach ($change in $results.Changes)
{
$change.Delta
}
Remove-AzResourceGroup -Name ExampleGroup