Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for key tasks, but consistently lists Azure PowerShell (a Windows-centric tool) first in each example section. The initial instructions and code samples prioritize PowerShell, which is more commonly used on Windows, before presenting Azure CLI commands that are cross-platform. There is also a focus on Windows-specific patterns, such as referencing %USERPROFILE% for cache location, and the use of PowerShell cmdlets, which may be less familiar or accessible to Linux/macOS users.
Recommendations
- Alternate the order of examples, sometimes showing Azure CLI first to avoid implicit prioritization of Windows tools.
- Explicitly state that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Provide Bash shell examples for common tasks, especially for Linux/macOS users.
- Clarify that PowerShell is available cross-platform, but Azure CLI may be more familiar to non-Windows users.
- Ensure all file path examples use platform-agnostic notation or show all platforms equally.
- Add a table or note summarizing tool availability and platform compatibility.
Create Pull Request