Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for creating and updating scale sets with Availability Zones, but PowerShell (a Windows-centric tool) is given equal prominence to CLI, and in some update scenarios, CLI and PowerShell are shown before REST API/ARM template. There are no explicit Linux/macOS shell examples (e.g., Bash), and the ARM template section references both Linux and Windows but does not provide a full Linux-specific example. The documentation does not mention any Linux-specific tools or patterns, and the PowerShell examples may not be directly usable on Linux/macOS without additional setup.
Recommendations
- Add explicit Bash shell examples for Linux/macOS users alongside Azure CLI commands.
- Clarify that Azure CLI is cross-platform and can be used on Linux/macOS, and provide installation/use links for those platforms.
- Ensure that Linux examples (e.g., ARM template for Linux VMs) are shown with equal detail and prominence as Windows examples.
- Consider listing Azure CLI (cross-platform) examples before PowerShell (Windows-centric) examples to reduce perceived Windows bias.
- Add notes or links for Linux/macOS users on how to use PowerShell Core if needed.
Create Pull Request