Detected Bias Types
Windows First
Powershell Heavy
Summary
The documentation provides parity between Azure Portal, Azure CLI, and PowerShell for all major operations. However, there is a mild Windows bias: PowerShell examples are given equal weight to CLI, and in some sections (e.g., 'Reassign an existing VM', 'Move a VM from dedicated host to multitenant infrastructure'), PowerShell is presented after CLI but with detailed variable usage and scripting, which is more familiar to Windows users. The CLI examples are cross-platform, but PowerShell is inherently Windows-centric (though available on Linux, it's less commonly used there). There are no explicit Linux-only examples (e.g., bash scripts), and the documentation does not mention Linux-specific tools or patterns. The Portal instructions are neutral.
Recommendations
- Add explicit bash script examples for common tasks to demonstrate Linux-native workflows.
- Clarify that Azure CLI is fully cross-platform and preferred for Linux/macOS users.
- Consider mentioning that PowerShell is available on Linux/macOS, but CLI is more typical for those platforms.
- Where relevant, note any differences in experience or prerequisites for Linux/macOS users (e.g., SSH keys, shell environment).
- If possible, add troubleshooting or tips sections for Linux users (e.g., dealing with az CLI installation, permissions, etc.).