Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides examples for Azure portal, Azure CLI, and Azure PowerShell for all major operations (attach, detach, move VMs). While Azure CLI is cross-platform and examples use Linux images (e.g., Ubuntu2204), PowerShell examples are included in every section and shown immediately after CLI, which may suggest a slight Windows bias. There are no Linux shell-specific examples (e.g., Bash scripts), and troubleshooting links sometimes point to Windows-specific documentation (e.g., proximity placement group migration). However, the CLI coverage ensures Linux/macOS users can complete all tasks.
Recommendations
- Consider explicitly stating that Azure CLI commands work on Linux/macOS and Windows, and that PowerShell is primarily for Windows users (with PowerShell Core available cross-platform, but less common on Linux).
- Add Bash script examples for common operations to further improve parity for Linux/macOS users.
- Where troubleshooting links point to Windows-specific docs, add or reference equivalent Linux documentation if available.
- Clarify in introductory sections that all operations can be performed from Linux/macOS using Azure CLI.