Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for creating and updating scale sets with Availability Zones. However, PowerShell examples are given equal prominence to CLI, and in some sections (such as 'Create zone spanning or zonal scale sets'), PowerShell is listed before ARM templates and REST API. There are no Linux-specific shell examples (e.g., Bash), and the CLI examples are generic but do not reference Linux-specific considerations. The documentation does not mention Windows tools exclusively, but the ordering and prominence of PowerShell may create a slight Windows bias.
Recommendations
- Ensure that Azure CLI examples are clearly labeled as cross-platform and, where relevant, provide Bash shell examples for Linux/macOS users.
- Consider listing Azure CLI examples before PowerShell in sections to emphasize cross-platform parity.
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows.
- Add notes or links for Linux/macOS users regarding SSH key generation and authentication differences, if relevant.
- Review the ordering of example sections to avoid implicit Windows prioritization.
Create Pull Request