Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a significant Windows bias by exclusively providing Azure PowerShell command-line examples, referencing Windows file paths (e.g., C:\CustomRoles\...), and omitting equivalent instructions for Linux/macOS users (such as Bash/CLI commands and POSIX file paths). All automation and scripting steps are shown using PowerShell, with no mention of Azure CLI or cross-platform alternatives. This can create friction for users on Linux or macOS, who may not have access to PowerShell or prefer native tools.
Recommendations
- Provide Azure CLI (az) command equivalents for all PowerShell examples, especially for role definition and assignment tasks.
- Use generic or POSIX-compliant file paths (e.g., /home/user/CustomRoles/) alongside Windows paths.
- Explicitly mention that PowerShell commands can be run on Linux/macOS (if true), or provide instructions for installing PowerShell Core cross-platform.
- Add notes or sections for Linux/macOS users, clarifying any differences in procedure.
- Consider presenting examples in a platform-neutral order, or grouping them by OS.
Create Pull Request