Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for all disk types and operations, but PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and in some sections (such as 'Share an existing disk' and 'Using Azure shared disks with your VMs'), PowerShell examples are shown before CLI. There are no Linux-specific shell examples (e.g., Bash), nor are there any Linux/macOS-specific notes or guidance. The documentation assumes parity between CLI and PowerShell, but PowerShell is a Windows-first tool, and its prominence may create friction for Linux/macOS users.
Recommendations
- Always present Azure CLI examples before PowerShell, as CLI is cross-platform and native to Linux/macOS.
- Add explicit Bash shell examples where appropriate, especially for mounting disks to Linux VMs.
- Include notes or links for Linux/macOS users on how to install and use Azure CLI.
- Provide guidance or examples for disk attachment and SCSI PR commands using Linux tools (e.g., sg_persist, multipath).
- Clarify that PowerShell is optional and not required for Linux/macOS users.
Create Pull Request