Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Windows and Linux examples for preparing data disks in scale sets, but the Windows (PowerShell) example is presented first and uses a named script (prepare_vm_disks.ps1) with explicit PowerShell invocation. The Linux example follows, using bash. The initial tutorial links list Azure CLI before PowerShell, but the main example section gives Windows precedence. There is a slight bias toward Windows/PowerShell in ordering and example prominence.
Recommendations
- Alternate the order of Windows and Linux examples, or present them side-by-side for parity.
- Explicitly state that both Windows and Linux are supported before showing examples.
- Provide equal detail and context for both PowerShell and Bash scripts (e.g., describe what each script does).
- Where possible, use cross-platform tools (e.g., Azure CLI) as the primary example, with OS-specific instructions as secondary.
- Add a note that Linux/macOS users can use Azure CLI and Bash for all operations, and link to relevant tutorials.
Create Pull Request