Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples and instructions for three interfaces: Azure Portal, PowerShell, and Azure CLI. PowerShell examples are given equal prominence to Azure CLI, but PowerShell is a Windows-centric tool, and its examples are presented before Azure CLI in every section. There are no examples for Bash, Linux shell scripting, or other Linux-native tools. The documentation assumes familiarity with PowerShell-specific cmdlets and patterns, which may disadvantage Linux users who typically use Bash or other shells. Azure CLI is cross-platform, but its examples are always secondary to PowerShell, and no explicit Linux-specific guidance is provided.
Recommendations
- Add Bash/Linux shell examples alongside PowerShell and Azure CLI, especially for condition and operation definitions.
- Present Azure CLI examples before PowerShell, as Azure CLI is cross-platform and more widely used on Linux.
- Explicitly mention that Azure CLI commands work natively on Linux/macOS and provide any necessary environment setup instructions.
- Avoid assuming PowerShell as the default scripting environment; clarify that PowerShell is primarily for Windows users.
- Consider including links or references to Linux-specific documentation or troubleshooting guides.
Create Pull Request