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 is sometimes listed before or alongside CLI. There are no explicit Linux shell (bash) examples, nor are Linux-specific considerations or tools mentioned. The ARM template section references both Linux and Windows, but does not provide a Linux shell example for deployment. The overall pattern is to treat Windows/PowerShell as a first-class or default environment, with limited explicit Linux parity.
Recommendations
- Add explicit bash shell examples for Linux/macOS users alongside Azure CLI and PowerShell sections.
- Ensure CLI examples are shown before PowerShell, as CLI is cross-platform and more commonly used on Linux/macOS.
- Clarify that Azure CLI commands work natively on Linux/macOS and provide installation links or notes for those platforms.
- Where PowerShell is mentioned, add a note that PowerShell Core is available cross-platform, but CLI is recommended for Linux/macOS.
- Provide a sample ARM template deployment using Azure CLI on Linux/macOS, not just the template JSON.
Create Pull Request