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 PowerShell examples for command-line and REST API operations, referencing Windows-centric tools (PowerShell cmdlets) throughout, and omitting equivalent Linux/macOS shell examples (such as Azure CLI or curl). The PowerShell approach is presented first and as the default for scripting, with no mention of cross-platform alternatives. This creates friction for Linux/macOS users who may not have access to PowerShell or prefer native tools.
Recommendations
- Add Azure CLI examples for all operations, especially for removing managed identities and verifying results.
- Provide REST API invocation examples using curl or httpie, which are standard on Linux/macOS.
- Explicitly mention that PowerShell is available cross-platform, but also offer native shell alternatives.
- Reorder examples so that cross-platform or platform-neutral methods (Azure CLI, REST API with curl) are presented before or alongside PowerShell.
- Include verification steps using Azure CLI (e.g., az automation account show) in addition to PowerShell.
Create Pull Request