Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. Many troubleshooting steps and examples reference Azure PowerShell cmdlets (e.g., Remove-AzRoleAssignment, Get-AzRoleAssignment) and provide detailed PowerShell command usage and error messages. In several cases, PowerShell is mentioned before Azure CLI, or CLI is only referenced as an alternative. There are no explicit Linux shell (bash) or cross-platform scripting examples, and no mention of Linux-specific tools or patterns. The troubleshooting steps and solutions assume familiarity with Windows/PowerShell environments, with no parity for Linux users.
Recommendations
- Provide equivalent bash/Azure CLI examples alongside PowerShell commands, especially for common operations like listing, creating, and removing role assignments.
- Ensure that Azure CLI examples are given equal prominence and detail as PowerShell examples, and avoid presenting PowerShell first unless justified.
- Include troubleshooting steps and error messages for Azure CLI on Linux/macOS, not just PowerShell on Windows.
- Add notes or sections clarifying cross-platform usage, including any differences in behavior or caching between PowerShell and CLI.
- Reference Linux/macOS environments explicitly when discussing command-line tools, and avoid assuming a Windows/PowerShell context.
Create Pull Request