Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias toward Windows and PowerShell usage. The ARM template deployment section exclusively provides Azure PowerShell instructions, with no Azure CLI or Bash example for Linux/macOS users. PowerShell is presented first and in greater detail, while CLI instructions are only available for Bicep deployments. There is no mention of Linux-native tools or workflows for ARM template deployment, and the initial deployment workflow assumes familiarity with PowerShell, which is primarily a Windows tool.
Recommendations
- Add Azure CLI (az) examples for ARM template deployment alongside PowerShell, especially in the ARM template tab.
- Present CLI and PowerShell instructions in parallel or allow users to select their preferred environment, rather than defaulting to PowerShell.
- Explicitly mention that Azure Cloud Shell supports both Bash and PowerShell, and provide Bash/CLI instructions for Linux/macOS users.
- Ensure that Linux/macOS users are not required to use PowerShell for deployment tasks, and clarify cross-platform options.
- Review the order of presentation so that CLI and PowerShell are given equal prominence, or allow users to select their OS/workflow first.
Create Pull Request