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 consistently presents Windows/PowerShell examples and tools before their cross-platform or Linux equivalents. PowerShell is given a prominent, detailed section before Azure CLI, and Visual Studio Code (a Microsoft product) is the only code editor mentioned for syntax validation. There are no Linux-specific examples, shell commands, or references to Linux-native editors or troubleshooting tools. The structure and tool recommendations implicitly prioritize Windows and Microsoft-centric workflows.
Recommendations:
- Alternate the order of PowerShell and Azure CLI sections, or present Azure CLI examples first in some sections to avoid implicit prioritization of Windows/PowerShell.
- Explicitly mention that Azure CLI commands work cross-platform (Windows, Linux, macOS) and provide example shell commands using Bash syntax where appropriate.
- Include references to popular Linux-native editors (e.g., Vim, Emacs, nano) and how to use them for ARM/Bicep syntax validation, or at least acknowledge their use.
- Clarify that Visual Studio Code is available cross-platform, and suggest alternative editors for Linux users.
- Add troubleshooting tips or examples that are specific to Linux environments, such as file path conventions or common shell errors.
- Ensure that all screenshots and output examples are either neutral or include Linux terminal examples where possible.
Create pull request
Flagged Code Snippets
Test-AzResourceGroupDeployment `
-ResourceGroupName examplegroup `
-TemplateFile azuredeploy.json
Test-AzResourceGroupDeployment: Cannot retrieve the dynamic parameters for the cmdlet.
Cannot find path '/tmp/11111111-1111-1111-1111-111111111111/main.json' because it does not exist.
Get-AzResourceGroupDeploymentOperation `
-DeploymentName exampledeployment `
-ResourceGroupName examplegroup
(Get-AzResourceGroupDeploymentOperation `
-DeploymentName exampledeployment `
-ResourceGroupName examplegroup).StatusCode
Get-AzResourceGroupDeployment `
-DeploymentName exampledeployment `
-ResourceGroupName examplegroup