Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Summary
The documentation provides both Azure CLI and PowerShell examples for enabling Automatic Zone Balance on Virtual Machine Scale Sets. However, PowerShell examples are consistently presented alongside CLI examples, and in some sections (such as feature registration), the PowerShell tab appears after CLI but before REST API. The PowerShell examples reference Windows-specific extension types (e.g., ApplicationHealthWindows), while the CLI examples use ApplicationHealthLinux. Portal instructions are platform-neutral, but PowerShell is a Windows-centric tool, and its presence may suggest Windows bias. REST API instructions are included, but Linux-specific guidance (e.g., Bash scripting, Linux-native tools) is not provided. The CLI examples use Ubuntu images, which is positive for Linux parity.
Recommendations
- Ensure that PowerShell examples are clearly marked as Windows-only and that Linux/macOS users are directed to Azure CLI or REST API.
- Provide Bash or shell script examples for Linux/macOS users where relevant.
- Clarify in the PowerShell section that it is primarily for Windows users, and recommend Azure CLI for cross-platform scenarios.
- Expand documentation to include troubleshooting or extension configuration for both Windows and Linux VMSS instances (e.g., ApplicationHealthWindows vs ApplicationHealthLinux).
- Consider listing Azure CLI examples before PowerShell to reinforce cross-platform parity.