Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page provides only Azure PowerShell examples for managing savings plan permissions, with no mention of cross-platform alternatives such as Azure CLI, Bash, or REST API usage from Linux/macOS environments. All scripting guidance is centered around PowerShell, which is traditionally associated with Windows, and there is no indication that these tasks can be performed from Linux or macOS. This creates a bias toward Windows users and may hinder Linux users from easily following the instructions.
Recommendations
- Add equivalent Azure CLI examples for all PowerShell scripts, demonstrating how to perform the same role assignments and management tasks using az commands.
- Explicitly state that Azure PowerShell is cross-platform and can be used on Linux and macOS, or provide installation instructions for these platforms.
- Include REST API examples (e.g., using curl or httpie) for advanced users who may prefer direct API calls from any OS.
- Clarify which tools (PowerShell, Azure CLI) are supported on which operating systems, and link to relevant installation guides.
- Consider reordering examples so that cross-platform tools (Azure CLI, REST API) are presented before or alongside PowerShell to avoid implicit prioritization of Windows workflows.
Create Pull Request