Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all major operations (attach, detach, update VMSS), but consistently lists PowerShell examples after CLI and before any Linux-specific shell scripts. The PowerShell examples use Windows-centric syntax (backticks, variable assignment), and troubleshooting links for disk migration and proximity placement groups point to Windows documentation first. There is no explicit Linux bias, but the ordering and example selection subtly favor Windows/PowerShell users.
Recommendations
- Ensure that Linux/macOS shell examples (e.g., Bash scripts) are provided where PowerShell is shown, especially for advanced scenarios.
- When linking to migration or troubleshooting guides, include both Windows and Linux documentation, or link to OS-neutral pages.
- Alternate the order of CLI and PowerShell examples, or group them under 'Command-line' with clear OS applicability.
- Explicitly state that Azure CLI works cross-platform and highlight any OS-specific caveats.
- Add notes or examples for common Linux/macOS patterns (e.g., using export for environment variables, handling file paths).
Create Pull Request