Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting Azure PowerShell commands as the primary or sole CLI example for scripting tasks, such as counting role assignments. References to PowerShell and Windows-centric tools (e.g., Get-AzRoleAssignment, Get-MgUser) are frequent and appear before or instead of Linux-friendly alternatives. While Azure CLI is mentioned for some user lookup tasks, it is not used for the main RBAC troubleshooting workflows. There are no Bash or Linux shell examples, and the documentation does not address cross-platform usage patterns or provide parity for Linux users.
Recommendations
- Provide equivalent Azure CLI (az) examples alongside PowerShell commands for all scripting tasks, especially for counting and managing role assignments.
- Explicitly mention that both Azure CLI and PowerShell are cross-platform, and clarify usage on Linux/macOS where appropriate.
- Include Bash shell script snippets for common workflows, such as listing and removing role assignments.
- Ensure that references to tools and commands do not default to Windows/PowerShell; alternate between CLI and PowerShell, or present both in tabs.
- Add notes or sections for Linux/macOS users, highlighting any differences or considerations in command syntax or environment setup.
Create Pull Request