Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all steps, but PowerShell is given equal prominence to CLI, despite CLI being cross-platform and PowerShell being primarily associated with Windows. There is no mention of Linux-specific patterns, nor is there any guidance for Linux users regarding shell environments or prerequisites. The documentation does not explicitly favor Windows tools, but the inclusion of PowerShell throughout and its parity with CLI may subtly reinforce Windows-centric workflows.
Recommendations
- Clearly indicate that Azure CLI is cross-platform and preferred for Linux/macOS users, while PowerShell is primarily for Windows.
- Add a note or section for Linux/macOS users, confirming that all CLI commands work natively in Bash/Zsh/etc.
- Consider listing CLI examples before PowerShell examples to reinforce platform neutrality.
- If PowerShell is included, clarify its availability on Linux/macOS, or link to installation instructions for non-Windows platforms.
- Avoid using Windows-specific terminology (e.g., 'local computer') and instead use 'local machine' or specify OS-neutral language.
Create Pull Request