Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides both Azure CLI (cross-platform) and Azure PowerShell (Windows-centric) examples for automating migration to Spot VMs. However, PowerShell is called out as the only alternative to CLI for automation, and is presented before the Azure portal (UI) method. There are no explicit Linux shell or Bash-specific examples, and PowerShell is highlighted as a primary automation method, which may bias towards Windows users. Additionally, the PowerShell section uses Windows-style command syntax and context variables, with no mention of Linux equivalents or cross-platform PowerShell usage.
Recommendations
- Add Bash shell script examples for common migration tasks, especially for validation and automation, to provide parity with PowerShell.
- Clarify that Azure CLI is fully cross-platform and can be used on Windows, Linux, and macOS, and consider listing it as the primary automation method.
- If PowerShell is included, specify that Azure PowerShell can also be run on Linux/macOS (with PowerShell Core), or provide explicit Bash alternatives.
- Where possible, avoid presenting Windows-centric tools (like PowerShell) before platform-agnostic or Linux-native tools.
- Add troubleshooting and validation examples using Bash/CLI pipelines (e.g., using jq or grep with az batch pool show) to help Linux users.
Create Pull Request