Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation consistently presents Azure PowerShell (a Windows-centric tool) as the first example in each section, followed by CLI and REST API. There are no Linux/macOS-specific shell examples (e.g., Bash), nor is there any mention of platform-specific considerations for Linux users. The reliance on PowerShell and its prominent placement may create friction for Linux/macOS users, though the Azure CLI and REST API are cross-platform and included.
Recommendations
- Alternate the order of examples, sometimes showing CLI first to avoid implicit prioritization of Windows tools.
- Explicitly mention that Azure CLI and REST API are cross-platform and suitable for Linux/macOS environments.
- Provide example commands using Bash or shell scripting for Linux users where relevant.
- Add a brief section clarifying platform compatibility for each tool, especially for PowerShell.
- Include troubleshooting notes for Linux/macOS users if PowerShell is referenced.
Create Pull Request