Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides step-by-step instructions for Azure portal, Azure PowerShell, and Azure CLI for all major operations. However, PowerShell examples are consistently presented before CLI examples, and PowerShell is a Windows-centric tool. There is no explicit mention of Linux-specific tools or shell scripting, nor are there any Bash script examples beyond basic CLI usage. The documentation does not reference Linux environments, nor does it discuss cross-platform considerations, which may implicitly favor Windows users due to the prominence and ordering of PowerShell instructions.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to avoid implicit Windows-first bias.
- Explicitly mention that Azure CLI works natively on Linux, macOS, and Windows, and provide guidance for Linux users where relevant.
- Include sample Bash scripts or automation workflows for Linux users, especially for multi-step operations.
- Add a brief section or note on cross-platform usage, clarifying that all CLI commands are fully supported on Linux and macOS.
- Where PowerShell is used for scripting, offer equivalent Bash or shell script snippets for Linux users.
- Reference Linux-specific troubleshooting tips or environment setup where appropriate.
Create Pull Request