Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell (a Windows-centric tool) is referenced first and more frequently than Azure CLI, including in parameter descriptions (e.g., 'Get it by using Get-AzSubscription cmdlet'). The instructions and examples for creating and deploying template specs prioritize PowerShell, and Windows-specific tools and patterns (such as Visual Studio Code, which is cross-platform but often associated with Windows) are mentioned. There are no explicit Linux shell (bash) examples, nor is there mention of Linux-specific considerations or parity in command usage.
Recommendations
- Provide Linux/bash equivalents for commands where PowerShell is referenced, especially for obtaining values like tenantId and objectId.
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to avoid implicit prioritization of Windows tools.
- Explicitly state that all CLI commands work on Linux, macOS, and Windows, and clarify any OS-specific differences if present.
- Include examples using native Linux tools (e.g., bash scripts, grep, jq) where appropriate.
- Avoid referencing only Windows-centric cmdlets in parameter descriptions; include Azure CLI or REST API alternatives.
Create Pull Request