Bias Analysis
Detected Bias Types
windows_tools
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for enabling Automatic Zone Balance on Virtual Machine Scale Sets. However, PowerShell (a Windows-centric tool) is given equal prominence to CLI, and there are several examples using PowerShell. The Application Health extension example in PowerShell uses 'ApplicationHealthWindows' as the extension type, while the CLI example uses 'ApplicationHealthLinux', which may cause confusion or friction for Linux users. Additionally, PowerShell examples are presented in all major sections, and the tab order sometimes places PowerShell before CLI, indicating a mild Windows-first bias.
Recommendations
- Ensure that Linux-focused examples (Azure CLI) are always presented before PowerShell in tab order and narrative.
- Clarify when to use 'ApplicationHealthLinux' vs 'ApplicationHealthWindows' extension types, and provide both examples in PowerShell and CLI sections.
- Explicitly state that Azure CLI is cross-platform and preferred for Linux/macOS users.
- Add a note or section for macOS users if any steps differ.
- Review tab ordering to ensure CLI is first, followed by PowerShell, to reduce Windows-first bias.
Create Pull Request