Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by providing explicit instructions and links for assigning roles using Azure PowerShell, a Windows-centric tool, while omitting equivalent CLI or scripting examples for Linux/macOS users. The portal-based instructions are platform-neutral, but the only automation example references PowerShell, and there are no Azure CLI or REST API command examples for Linux environments.
Recommendations
- Add equivalent Azure CLI examples for assigning roles to service principals, as Azure CLI is cross-platform and widely used on Linux/macOS.
- When referencing automation, provide both PowerShell and CLI (az) command examples side-by-side.
- Mention REST API options for permissions assignment, including example requests, to ensure platform neutrality.
- Avoid referencing PowerShell before CLI or REST API unless there is a clear reason; consider presenting cross-platform tools first.
- Explicitly state that all steps can be performed on Linux/macOS using Azure CLI or REST API, and provide links or code snippets accordingly.
Create Pull Request