Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides examples exclusively for Azure CLI and Azure PowerShell, with no explicit Linux/macOS shell examples or instructions. While Azure CLI is cross-platform, PowerShell is traditionally associated with Windows, and its usage is emphasized throughout. There are no Linux-specific tools, shell commands, or platform notes, and Windows-centric images (e.g., Windows Server Core) are highlighted without Linux equivalents. The ordering of examples sometimes places PowerShell first or equally, which may subtly prioritize Windows users.
Recommendations
- Explicitly state that Azure CLI commands work on Linux/macOS and provide example shell environments (e.g., bash, zsh) for clarity.
- Add Linux/macOS-specific notes or troubleshooting tips where platform differences may affect usage (e.g., authentication, file paths, environment variables).
- Include Linux container image examples (e.g., Ubuntu, Alpine) alongside Windows images to demonstrate parity.
- Clarify that PowerShell Core is available cross-platform, or de-emphasize PowerShell in favor of CLI for platform-neutral documentation.
- Where possible, add sample commands using native Linux tools (e.g., curl, wget) for related tasks, or link to such resources.
Create Pull Request