Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by providing a PowerShell (az CLI) deployment example without mentioning or providing equivalent Linux/macOS shell commands. The only CLI example is shown using PowerShell syntax, and there is no explicit mention of Linux or cross-platform command-line usage. Additionally, the Azure portal is referenced as an alternative, but no Linux-specific tools, shell commands, or considerations are discussed.
Recommendations
- Provide both Windows (PowerShell) and Linux/macOS (bash) command-line examples for az CLI commands, making it clear that the Azure CLI is cross-platform.
- Explicitly mention that the az CLI commands work on all major platforms and show the command in a generic shell format (e.g., az deployment group create ...) without PowerShell-specific syntax.
- If any file paths or environment variables are referenced, show both Windows and Linux/macOS formats.
- Add a note or section clarifying that all steps can be performed from Linux, macOS, or Windows, and link to Azure CLI installation instructions for all platforms.
- Avoid implying that PowerShell is the default or only supported shell for these operations.
Create Pull Request