Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell instructions for verifying results, but the PowerShell example is given equal prominence and detail as the CLI example, despite PowerShell being primarily a Windows tool. There is no explicit mention of Linux-specific tools or shell environments (e.g., Bash), nor is there guidance for Linux users beyond the Azure CLI, which is cross-platform. The order of presentation (CLI first, then PowerShell) is neutral, but the inclusion of PowerShell may imply a Windows-centric audience.
Recommendations
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide example shell environments (e.g., Bash, zsh) for Linux users.
- Add a note clarifying that PowerShell is available cross-platform, but is most commonly used on Windows.
- Consider including Linux-specific verification steps, such as using Bash scripts or native Linux tools, if relevant.
- Ensure that troubleshooting and cleanup instructions mention any OS-specific considerations (e.g., file permissions, environment variables) for Linux users.
- Review the documentation for any implicit assumptions about the user's operating system and make instructions OS-agnostic where possible.
Create Pull Request