Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for assigning Azure roles using the Azure portal, PowerShell, Azure CLI, and ARM templates. However, the PowerShell example is given before the Azure CLI example, and PowerShell is a Windows-centric tool. There is no mention of Linux-specific tools or shell environments (e.g., Bash), nor are there any explicit Linux command-line examples or notes about cross-platform usage. The documentation implicitly assumes familiarity with PowerShell, which may disadvantage Linux users.
Recommendations
- Present Azure CLI examples before PowerShell examples, as Azure CLI is cross-platform and widely used on Linux.
- Add explicit notes that Azure CLI commands work on Linux, macOS, and Windows, while PowerShell is primarily a Windows tool (with cross-platform support, but less common on Linux).
- Include Bash shell examples or instructions for Linux users, especially for authentication and environment setup.
- Mention that Azure CLI can be installed and used natively on Linux, and provide links or references to installation guides for Linux.
- Avoid assuming PowerShell as the default scripting environment; clarify tool parity and usage scenarios for both Windows and Linux users.
Create Pull Request