Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides extensive PowerShell examples, which are primarily relevant for Windows users. The PowerShell section is significantly longer and more detailed than the CLI section, including advanced networking and load balancer configuration. Windows-specific tools (PowerShell cmdlets) are featured, and the PowerShell tab appears after CLI but before Linux-native scripting options (none are given). There are no Bash or Linux shell script equivalents for the advanced scenarios, and the CLI examples use generic Azure CLI commands but do not provide parity for the advanced PowerShell scenarios.
Recommendations
- Add Bash/Linux shell script examples for advanced scenarios currently covered only by PowerShell (e.g., networking, load balancer, and full VMSS configuration).
- Explicitly mention Linux/macOS compatibility for CLI commands and provide troubleshooting tips for non-Windows environments.
- Reorder examples to present CLI (cross-platform) before PowerShell, and clarify that PowerShell is Windows-centric.
- Where PowerShell cmdlets are used for resource creation, provide equivalent Azure CLI or ARM template examples.
- Highlight SSH key usage and Linux admin practices in examples, not just generic admin/password prompts.
Create Pull Request