Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation demonstrates a moderate Windows bias. PowerShell (a Windows-centric tool) is consistently presented first in command examples and explanations, with more detailed PowerShell output samples. Output examples and walkthroughs default to PowerShell syntax and screenshots, even when Azure CLI (cross-platform) equivalents are available. There is no mention of Linux-specific shell environments or considerations, and the only installation guidance for PowerShell assumes a Windows context. The documentation does not provide Linux-specific troubleshooting, nor does it mention using Bash or other native Linux shells.
Recommendations
- Alternate the order of PowerShell and Azure CLI sections/examples, or present Azure CLI first to reflect its cross-platform nature.
- Provide output and walkthrough examples for both PowerShell and Azure CLI, including screenshots and text outputs for each.
- Explicitly mention that Azure CLI commands work natively on Linux/macOS and provide any relevant Linux-specific notes (e.g., differences in shell syntax, file paths, or color support).
- Include installation instructions for Azure PowerShell on Linux/macOS, or clarify that Azure CLI is the recommended tool for those platforms.
- Where possible, use neutral, cross-platform language (e.g., 'shell' instead of 'PowerShell') and avoid assuming a Windows environment.
- Add troubleshooting tips or notes for common Linux/macOS issues (e.g., permissions, environment variables, color output in different terminals).
Create Pull Request