Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation exclusively uses Azure PowerShell commands and Windows file paths (e.g., C:\CustomRoles\...), with no mention of Azure CLI, Bash, or Linux/macOS equivalents. All automation and scripting examples are PowerShell-centric, and instructions for editing and storing files assume a Windows environment. This creates friction for Linux/macOS users, who must adapt commands and paths or switch tools.
Recommendations
- Provide equivalent Azure CLI commands for all PowerShell examples, especially for role definition and assignment tasks.
- Use platform-neutral file paths in examples (e.g., /home/user/CustomRoles/...), or show both Windows and Linux/macOS paths.
- Explicitly mention that PowerShell commands can be run on Linux/macOS, or link to cross-platform installation guides.
- Include Bash or shell script examples for common tasks.
- Add a note at the start clarifying tool parity and linking to documentation for both PowerShell and Azure CLI.
Create Pull Request