Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation presents PowerShell examples before Azure CLI, and the PowerShell section is more detailed, which may indicate a Windows-first and PowerShell-heavy bias. While Azure CLI is cross-platform and included, there are no explicit Linux-specific instructions, nor are Linux shell patterns (e.g., bash, environment variables) mentioned. The documentation does not reference Windows-only tools, but the ordering and emphasis favor Windows users.
Recommendations
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to emphasize cross-platform parity.
- Add explicit notes or examples for Linux/macOS users, such as bash shell usage, environment variable substitution, or installation instructions for Azure CLI on Linux.
- Ensure that CLI examples use syntax and conventions familiar to Linux users (e.g., single quotes, environment variables).
- Clarify that both PowerShell and Azure CLI are available on Windows, Linux, and macOS, and provide links to installation guides for each platform.
- Consider adding a table comparing usage across platforms, or a section highlighting platform-agnostic approaches.
Create Pull Request