Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation demonstrates a Windows bias by prioritizing PowerShell instructions and referencing running scripts in Visual Studio Code locally, which is most commonly used on Windows. While Azure CLI examples are provided (which are cross-platform), the instructions and context often mention PowerShell first and suggest running commands in environments typically associated with Windows. There are no explicit Linux shell examples (e.g., bash scripts), nor is there mention of Linux-specific tooling or workflows. The use of 'Azure Cloud Shell' mitigates some bias, but local execution is described primarily in Windows-centric terms.
Recommendations
- Provide explicit bash shell examples for Linux users, including variable assignment and script execution.
- Mention Linux and macOS environments as valid options for running Azure CLI commands, not just Visual Studio Code or PowerShell.
- Clarify that Azure CLI commands can be run natively on Linux/macOS terminals, and provide any necessary notes about differences (e.g., environment variable syntax).
- Include screenshots or references to Linux desktop environments where appropriate.
- Avoid suggesting PowerShell as the default local scripting environment; present both PowerShell and bash options equally.
Create Pull Request