Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation, while focused on Linux VMs, consistently presents PowerShell-based examples and instructions alongside Azure CLI and Portal methods. PowerShell is a Windows-centric tool, and its inclusion (and occasional prioritization) may create friction for Linux/macOS users. Additionally, references to 'installing Azure PowerShell locally' and using PowerShell cmdlets are present in multiple sections, sometimes before Azure CLI alternatives. The documentation does not provide native Linux shell (bash) or scripting examples, and relies heavily on Azure PowerShell, which is less common on Linux platforms.
Recommendations
- Prioritize Azure CLI examples over PowerShell in Linux-focused documentation, as CLI is cross-platform and more familiar to Linux users.
- Where PowerShell is mentioned, clarify its cross-platform availability and provide installation instructions for Linux/macOS if relevant.
- Add native bash script examples for common tasks (listing, installing, uninstalling extensions) to improve accessibility for Linux users.
- Review the order of examples and instructions to ensure CLI and Portal methods are presented before PowerShell in Linux documentation.
- Consider removing or minimizing references to Windows-specific tools unless they offer unique functionality not available in CLI.
Create Pull Request