Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is featured as a primary automation option, and references to PowerShell modules and commands are prominent in both prerequisites and procedural sections. The prerequisites detail PowerShell installation and usage before mentioning CLI, and PowerShell-specific instructions are included even when functionality is limited (e.g., associating an ASG with an existing private endpoint is noted as unsupported in PowerShell). The CLI instructions are present and generally platform-agnostic, but the overall structure and language favor Windows/PowerShell tools and patterns.
Recommendations
- Ensure CLI instructions are presented before or alongside PowerShell instructions to promote platform neutrality.
- Clarify that Azure CLI works natively on Linux, macOS, and Windows, and provide explicit Linux/macOS terminal examples (e.g., bash syntax, environment setup).
- Reduce emphasis on PowerShell-specific prerequisites unless necessary, and highlight CLI as the recommended cross-platform tool.
- Add troubleshooting or environment setup notes for Linux users (e.g., installing Azure CLI on Ubuntu, using bash variables).
- Where PowerShell functionality is limited, suggest alternative CLI workflows for Linux/macOS users.
Create Pull Request