Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation provides examples for Azure CLI, Azure PowerShell, and the Azure Portal. While Azure CLI is cross-platform, the inclusion of Azure PowerShell (which is historically Windows-centric and still most commonly used on Windows) and the explicit mention of PowerShell-specific parameters (e.g., -UseTenantScope) indicate a Windows bias. Additionally, the reference to 'Azure PowerShell' is given equal prominence to Azure CLI, and there are no examples using Linux-native shells or tools (e.g., bash scripting, piping, jq). The documentation does not mention or demonstrate Linux-specific patterns, nor does it clarify cross-platform compatibility for PowerShell.
Recommendations
- Add explicit notes clarifying that Azure CLI commands work identically on Linux, macOS, and Windows.
- Provide Linux shell (bash) examples where relevant, such as using environment variables, piping, or text processing.
- Clarify whether Azure PowerShell commands are fully supported on Linux/macOS and provide installation or usage notes if so.
- Consider including examples using other cross-platform scripting languages (e.g., Python with Azure SDK) for broader parity.
- Avoid presenting PowerShell as the default or primary scripting option unless cross-platform support is clearly stated.
Create Pull Request