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 examples, and in some sections (such as updating scale sets), PowerShell is listed before REST API and after CLI. There is no explicit Linux shell example (e.g., Bash), and PowerShell is a Windows-centric tool, though it is now cross-platform. The CLI example uses az CLI, which is cross-platform, but there are no explicit Linux/macOS shell commands or notes about Linux-specific considerations. The Resource Manager template section references both Linux and Windows getting started articles, which is positive for parity. Overall, the bias is minor and mostly in the ordering and prominence of PowerShell.
Recommendations
- Ensure that CLI (az CLI) examples are always listed first, as they are cross-platform and preferred for Linux/macOS users.
- Add explicit Bash shell examples or notes clarifying that Azure CLI commands work on Linux/macOS terminals.
- Where PowerShell is used, clarify that it is available cross-platform, or provide Bash equivalents if there are any subtle differences.
- Consider adding a brief section or note for Linux/macOS users to highlight any OS-specific considerations or prerequisites.