Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias by exclusively providing Azure PowerShell (Windows-centric) command examples, referencing Windows file paths (e.g., C:\CustomRoles\), and omitting any equivalent instructions or examples for Linux users (such as Azure CLI or Bash). There is no mention of Linux tools or cross-platform command alternatives, and PowerShell is presented as the default/only automation method.
Recommendations
- Provide equivalent Azure CLI (az) command examples for all PowerShell commands, ensuring Linux and macOS users can follow along.
- Use cross-platform file paths in examples (e.g., ~/CustomRoles/ or /home/user/CustomRoles/) or note both Windows and Linux path formats.
- Explicitly mention that the steps can be performed on Linux/macOS using Azure CLI or PowerShell Core, and provide links to relevant documentation.
- Add a section or callout highlighting cross-platform support and any differences in command syntax or tooling.
- Where referencing external tutorials (e.g., for custom roles), link to both PowerShell and Azure CLI versions if available.
Create Pull Request