Detected Bias Types
Powershell Heavy
🔧
Windows Tools
Windows First
Summary
The documentation provides examples for Azure portal, Azure CLI, Azure PowerShell, and ARM templates. While Azure CLI and ARM templates are cross-platform, the PowerShell section is extensive and detailed, with multi-step examples and notes. There is no mention of Bash, shell scripting, or Linux-specific tools. PowerShell is a Windows-native tool (though available on Linux, it is far less common), and its prominence may create friction for Linux/macOS users. Additionally, PowerShell examples are presented before programming language samples, and no explicit Linux/macOS command-line examples (e.g., Bash, curl, REST API) are given.
Recommendations
- Add Bash or shell script examples using Azure CLI to demonstrate parity for Linux/macOS users.
- Clarify that Azure CLI commands work identically on Windows, Linux, and macOS.
- Reduce the prominence of PowerShell by presenting CLI examples first, or by balancing CLI and PowerShell sections.
- Explicitly mention cross-platform support for all tools and provide guidance for Linux/macOS users where relevant.
- Consider adding REST API examples for users who prefer direct HTTP calls.