Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides parallel tutorials for Azure portal, Azure CLI, Azure PowerShell, and ARM templates. However, the PowerShell section is given equal prominence to the CLI section, despite PowerShell being primarily a Windows-centric tool (even though it is cross-platform now, it is still most commonly associated with Windows). There are no explicit Linux-specific examples or mentions of Linux-native tools (such as Bash scripts or references to Linux environments). The CLI section is generic and does not clarify usage on Linux, nor does it provide Bash or shell script examples. The ordering of sections (CLI before PowerShell) is neutral, but the inclusion of PowerShell as a primary automation method may reinforce a Windows bias.
Recommendations
- Add explicit Bash or shell script examples for Linux users, especially in the CLI section.
- Clarify that Azure CLI commands work on Linux, macOS, and Windows, and provide instructions for installing and using Azure CLI on Linux.
- Consider adding a section or note about using REST API calls with curl or other Linux-native tools.
- If PowerShell is included, clarify its cross-platform availability and provide examples for both Windows PowerShell and PowerShell Core on Linux.
- Ensure that Linux users are aware of equivalent workflows and tools, and provide parity in examples and instructions.
Create Pull Request