Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both PowerShell and Azure CLI examples for key operations, but PowerShell (a Windows-centric tool) is consistently presented first in each example section. This ordering may subtly prioritize Windows users and workflows. There is no explicit mention of Linux-specific shell patterns (e.g., bash), nor are there examples using native Linux tools or shell idioms. However, Azure CLI examples are present, which are cross-platform.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to reflect its cross-platform nature.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell environments (e.g., bash, zsh) where appropriate.
- Add notes or examples for Linux/macOS users, such as how to run Azure CLI commands in bash, and clarify any differences in environment variables or command syntax.
- Consider including screenshots or terminal output from Linux environments to reinforce parity.
- Review language to ensure it does not assume a Windows environment (e.g., avoid phrases like 'open PowerShell' without alternatives).
Create Pull Request