Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by providing PowerShell examples as the only command-line method for querying role assignments, mentioning PowerShell before Azure CLI in several places, and referencing Windows-centric tools and patterns. While Azure CLI is mentioned as an alternative for some user queries, there are no CLI or Bash examples for the main RBAC troubleshooting tasks. This may disadvantage Linux/macOS users or those who prefer cross-platform tools.
Recommendations
- For every PowerShell example, provide an equivalent Azure CLI example (az commands) and, where appropriate, Bash shell scripting examples.
- When listing options for retrieving user or role information, mention Azure CLI before or alongside PowerShell, not after.
- Avoid assuming the use of Windows tools; use cross-platform terminology and tools wherever possible.
- Explicitly state that all examples are cross-platform, or provide platform-specific tabs (e.g., PowerShell, Azure CLI, Bash) for code samples.
- Review all references to PowerShell and ensure that equivalent steps using Azure CLI or REST API are included and clearly documented.
- Where screenshots or UI instructions are given, clarify that the Azure portal is accessible from any OS/browser.
Create Pull Request