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 listed first. There are no Linux-specific shell examples (e.g., Bash), nor are there any notes about Linux-specific considerations or parity for command-line usage. The documentation assumes PowerShell is equally available to all users, which is not the case for many Linux/macOS environments.
Recommendations
- List Azure CLI examples before PowerShell, as CLI is cross-platform and native to Linux/macOS.
- Add explicit Bash shell examples for common operations, especially for mounting disks to VMs.
- Include notes or links about installing and using Azure PowerShell on Linux/macOS, or clarify when PowerShell is required.
- Provide Linux-specific guidance for post-attach steps (e.g., mounting disks, SCSI PR usage) where relevant.
- Ensure screenshots and portal instructions do not assume Windows conventions (e.g., file paths, UI terminology).
Create Pull Request