Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides both Azure CLI (Bash) and Azure PowerShell examples for all command-line instructions, but PowerShell is given equal or greater prominence throughout. Prerequisites and installation steps frequently mention PowerShell and Windows-specific modules (Az.App), sometimes before or alongside Azure CLI. There are no Linux/macOS-specific troubleshooting tips, nor any mention of platform-specific differences. The use of PowerShell and references to Windows tooling may create friction for Linux/macOS users, but CLI parity is maintained.
Recommendations
- Clearly indicate that Azure CLI commands work cross-platform (Linux/macOS/Windows) and are preferred for non-Windows users.
- Move Azure CLI (Bash) examples before PowerShell in all code blocks and instructions, or default to CLI unless PowerShell is required.
- Add notes clarifying that PowerShell examples are intended for Windows users, and that Linux/macOS users should use Bash/CLI.
- Include troubleshooting notes for Linux/macOS environments (e.g., permissions, shell differences, path issues).
- Reduce references to Windows-specific modules unless strictly necessary, and provide alternatives or clarifications for other platforms.
Create Pull Request