Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation consistently provides Azure PowerShell examples alongside Azure CLI and portal instructions, with PowerShell examples always presented before CLI examples. This ordering subtly prioritizes Windows tooling and patterns, as PowerShell is most commonly used on Windows. However, Azure CLI examples are present for all major steps, ensuring Linux/macOS users are not blocked. No steps are Windows-only, and no critical functionality is missing for Linux/macOS users.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to better reflect cross-platform usage.
- Explicitly mention that Azure CLI is fully supported on Linux/macOS and is recommended for those platforms.
- Where possible, add notes about cross-platform compatibility for both CLI and PowerShell.
- Consider adding Bash script snippets for common automation scenarios to further support Linux users.
- Avoid language that implies PowerShell is the default or preferred method unless justified by feature parity.
Create Pull Request