Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deploying ARM templates, but it includes extensive PowerShell instructions, which are primarily associated with Windows environments. The Azure PowerShell tab is presented as a first-class option alongside Azure CLI, and PowerShell is given equal coverage for all programming languages, including a dedicated 'programming-language-powershell' pivot. There is no mention of Linux-specific shell environments (e.g., Bash), nor are there examples using Bash scripts or Linux-native tools. The use of Azure Cloud Shell is referenced, which can run on both Windows and Linux, but the script examples are written in Azure CLI and PowerShell only. There is no explicit Linux bias, but the documentation leans towards Windows-centric tooling and scripting patterns.
Recommendations
- Add Bash script examples for deploying ARM templates, especially for users on Linux or macOS.
- Clarify that Azure CLI commands work cross-platform and can be run in Bash, Zsh, or other Linux shells.
- Include notes or pivots for Linux/macOS users, highlighting any differences or prerequisites.
- Reduce the emphasis on PowerShell by making Azure CLI the default or first example, as it is cross-platform.
- Mention Linux-native tools (e.g., curl, jq) where relevant for template management or deployment.
- Explicitly state that Azure Cloud Shell supports both Bash and PowerShell, and provide examples for both.
Create Pull Request