Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides examples for Azure Portal, Azure CLI, and Azure PowerShell. While Azure CLI is cross-platform, Azure PowerShell is primarily associated with Windows environments, and its inclusion alongside CLI in every example can suggest a Windows bias. Additionally, the ordering of examples consistently places Azure PowerShell immediately after Azure CLI, and the documentation metadata includes 'devx-track-azurepowershell' before 'devx-track-azurecli', indicating a possible preference for Windows-centric tools. There are no explicit Linux-only examples, nor are Linux-specific patterns or shell commands (e.g., Bash, zsh) mentioned. REST API is referenced only in 'Next steps', not in the main workflow.
Recommendations
- Add explicit Bash or shell script examples for Linux users, especially for common tasks like listing, registering, and unregistering features.
- Clarify that Azure CLI commands work identically across Windows, Linux, and macOS, and highlight this cross-platform compatibility.
- Consider reordering examples to present Azure CLI before Azure PowerShell, or group cross-platform tools together, to avoid implicit Windows-first bias.
- Include REST API examples in the main workflow, not just in 'Next steps', to provide parity for users who prefer direct API calls.
- Add notes or links for installing and using Azure CLI and PowerShell on Linux and macOS, ensuring users know these tools are available cross-platform.
Create Pull Request