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
Summary:
The documentation provides both Azure CLI and PowerShell examples for deployment and cleanup steps, but consistently lists PowerShell (a Windows-centric tool) alongside CLI, and sometimes before or equally with CLI. There are no Linux-specific shell examples (e.g., Bash), and the prerequisites mention Visual Studio Code and PowerShell before CLI, which may suggest a slight Windows-first orientation. However, the use of Azure CLI does support cross-platform usage. There are no exclusive Windows tools or patterns, but the presence and prominence of PowerShell may be seen as a bias.
Recommendations:
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and consider providing Bash shell examples or notes for Linux users.
- List Azure CLI before PowerShell in all sections, as CLI is cross-platform and more inclusive.
- In prerequisites, clarify that Visual Studio Code and Azure CLI are available on Linux and macOS, not just Windows.
- Optionally, add a section or callout for Linux/macOS users, highlighting any differences or confirming parity.
- Avoid implying that PowerShell is required for non-Windows users; mention that PowerShell Core is cross-platform if relevant.
Create pull request
Flagged Code Snippets
New-AzResourceGroup -Name troubleshootRG -Location westus
New-AzResourceGroupDeployment `
-ResourceGroupName troubleshootRG `
-TemplateFile troubleshoot.json `
-prefixName long!!StoragePrefix
New-AzResourceGroup -Name troubleshootRG -Location westus
New-AzResourceGroupDeployment `
-ResourceGroupName troubleshootRG `
-TemplateFile troubleshoot.json `
-prefixName storage
Remove-AzResourceGroup -Name troubleshootRG