Bias Analysis
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 VM Scale Sets. However, PowerShell (a Windows-centric tool) is consistently presented alongside CLI, and in some sections, PowerShell examples reference Windows-specific extension types (e.g., ApplicationHealthWindows), while CLI examples reference ApplicationHealthLinux. The PowerShell examples are not clearly marked as Windows-only, and PowerShell is presented as a first-class option, which may create friction for Linux/macOS users. Portal instructions are platform-neutral, but PowerShell is a Windows tool and is not available natively on most Linux/macOS systems.
Recommendations
- Clearly indicate that Azure PowerShell is primarily for Windows users and recommend Azure CLI for Linux/macOS users.
- Ensure that all extension examples (e.g., Application Health) are shown for both Linux and Windows, and clarify which is appropriate for each OS.
- Consider presenting Azure CLI examples before PowerShell, as CLI is cross-platform.
- Add explicit notes or links for Linux/macOS users about how to install and use Azure CLI.
- Where PowerShell is used, clarify if the example is Windows-specific or if PowerShell Core is supported on Linux/macOS.
Create Pull Request