Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Azure CLI and PowerShell examples for all major tasks, but PowerShell (a Windows-centric tool) is frequently mentioned first, and its cmdlets are referenced in critical workflow descriptions. There is a notable emphasis on PowerShell usage, including variable initialization and script blocks, which may be less familiar or accessible to Linux/macOS users. Additionally, references to 'PowerShell session' and the use of PowerShell-specific terminology (cmdlets, parameters) reinforce a Windows-centric approach, even though the content is for Linux VMs.
Recommendations
- Present Azure CLI examples before PowerShell examples, as CLI is cross-platform and native to Linux/macOS.
- Minimize PowerShell-specific terminology in general workflow descriptions; use neutral or CLI-focused language.
- Clarify that Azure CLI is the recommended tool for Linux/macOS users and highlight its parity with PowerShell.
- Where variable initialization or scripting is shown, provide equivalent bash shell script examples alongside PowerShell.
- Review backup and snapshot instructions to ensure CLI and portal methods are equally emphasized, not PowerShell-first.
Create Pull Request