Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a moderate Windows bias: PowerShell is presented as a primary automation tool alongside Azure CLI, and in some places, PowerShell examples are given equal or greater prominence than CLI/Bash. The CLI examples reference Bash but do not provide explicit Linux shell guidance or mention cross-platform differences. There is no mention of Linux-specific tools or environments, and the PowerShell examples assume familiarity with Windows-centric scripting. The documentation does not clarify that Azure CLI is cross-platform or provide explicit Linux shell examples, and there is no mention of Linux-native scripting or automation approaches.
Recommendations
- Explicitly state that Azure CLI is cross-platform and works on Linux, macOS, and Windows.
- Provide example commands in both Bash (Linux/macOS) and PowerShell (Windows), especially where scripting or variable assignment is shown.
- Avoid presenting PowerShell examples before or with equal prominence to Bash/CLI unless justified by usage statistics; prioritize Bash for CLI examples.
- Where PowerShell is used, clarify that it is available cross-platform, but also provide native Bash alternatives for Linux users.
- Include notes or sections on running these commands in Linux environments (e.g., Ubuntu, CentOS), and address any OS-specific considerations.
- Mention Linux-native automation tools or scripting (e.g., shell scripts) where relevant.
- Ensure screenshots and UI references do not assume a Windows environment unless unavoidable.
Create Pull Request