Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, REST API, and Azure portal. However, PowerShell is featured prominently and referenced in links (e.g., 'Assign Azure roles' links to PowerShell docs), and PowerShell examples are given equal or greater prominence than CLI. There is a lack of explicit Linux shell (bash) examples, and no mention of Linux-specific tooling or patterns. REST API and Azure CLI are cross-platform, but PowerShell is a Windows-centric tool, and its inclusion without Linux shell equivalents suggests a Windows bias. Additionally, the documentation references PowerShell before CLI in some places and links to PowerShell documentation for further reading.
Recommendations
- Add explicit bash/shell examples for Linux users, especially for role assignment and data boundary configuration.
- Ensure Azure CLI is presented before PowerShell in example tabs and documentation links, as CLI is more cross-platform.
- Include notes clarifying that Azure CLI commands work natively on Linux/macOS, while PowerShell may require installation and configuration.
- Provide links to Azure CLI documentation in addition to or before PowerShell documentation.
- Consider mentioning Linux-native tools or patterns where appropriate, and avoid assuming PowerShell is the default scripting environment.
Create Pull Request