Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation exclusively uses Azure PowerShell for all examples and instructions, with no mention of Azure CLI, Bash, or Linux/macOS workflows. All commands and setup steps are tailored to PowerShell, which is traditionally a Windows-centric tool, and there is no guidance for users on Linux or macOS platforms. This creates friction for non-Windows users and may prevent them from easily following the documentation.
Recommendations
- Provide equivalent Azure CLI examples for each PowerShell command, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Add a section describing platform requirements and alternatives, clarifying that PowerShell Core is available cross-platform but Azure CLI may be preferable for Linux/macOS users.
- Reorder or parallelize examples so that both PowerShell and CLI/Bash instructions are presented side-by-side or in separate tabs.
- Explicitly mention installation and authentication steps for Azure CLI, not just PowerShell.
Create Pull Request