Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation page demonstrates Windows bias in several ways: PowerShell is presented as a primary command-line option alongside the Azure Portal, with Azure CLI examples following PowerShell and even incorrectly labeled as 'PowerShell command' in the CLI section. There is a strong emphasis on PowerShell usage, which is native to Windows, and no mention of Linux-specific shell environments or patterns. The ordering of examples consistently places Windows-centric tools (Portal, PowerShell) before cross-platform alternatives (Azure CLI).
Recommendations
- Correct the labeling in the Azure CLI sections to remove references to PowerShell, ensuring clarity for Linux/macOS users.
- Explicitly mention that Azure CLI commands can be run in Bash, Zsh, or other Linux/macOS shells, and provide example shell environments.
- Where PowerShell is referenced, consider providing equivalent Bash commands for common tasks (e.g., string manipulation, file copying) if relevant.
- Add notes or sections for Linux/macOS users, such as how to install and use Azure CLI on those platforms.
- Consider alternating the order of examples (e.g., present Azure CLI before PowerShell in some sections) to avoid reinforcing a Windows-first perspective.
- Review and update any terminology that assumes a Windows environment (e.g., 'PowerShell command' for CLI examples) to be platform-neutral.
Create Pull Request