Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a notable Windows bias, especially in the backend VM creation and testing sections. It exclusively uses Windows Server VMs and PowerShell commands to install IIS for testing, without mentioning or providing Linux alternatives (e.g., Ubuntu VM, Apache/Nginx setup). The VM creation walkthrough defaults to Windows Server, and all example scripts use PowerShell, with no Bash or Linux CLI equivalents. This creates friction for Linux/macOS users who may prefer or require Linux-based backend servers.
Recommendations
- Include parallel instructions for creating a Linux VM (e.g., Ubuntu) as a backend server.
- Provide Linux-specific commands (Bash/CLI) for installing a web server (e.g., Apache or Nginx) for testing.
- Offer Azure CLI examples alongside PowerShell, especially for extension installation and VM configuration.
- Explicitly mention that Application Gateway supports both Windows and Linux backend targets.
- Present both Windows and Linux options in examples, or clarify that the choice of OS is arbitrary for the gateway.
Create Pull Request