Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment operations. However, PowerShell examples are presented before CLI examples in several sections, and PowerShell is given its own dedicated tab, which can be perceived as a Windows-first approach. There is no mention of Linux-specific shell usage (e.g., Bash), nor are there examples tailored for Linux users (such as shell scripting or use of native Linux tools). The CLI examples are generic and do not reference Bash or Linux-specific conventions. There is also no mention of cross-platform compatibility or guidance for Linux users.
Recommendations
- Alternate the order of Azure CLI and PowerShell examples so that CLI (cross-platform) is shown first in some sections.
- Explicitly mention that Azure CLI commands work natively on Linux, macOS, and Windows, and provide Bash-specific examples where appropriate.
- Add notes or examples for running deployments from Bash scripts or Linux environments, highlighting any differences or considerations.
- Include references to Linux-native tools or environments (such as Bash, zsh, or Cloud Shell on Linux) where relevant.
- Ensure that documentation language is inclusive of all platforms, not assuming PowerShell as the default or primary method.
Create Pull Request