Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all deployment and management tasks. However, PowerShell examples are given equal prominence and detail as CLI, and PowerShell is a Windows-centric tool. The variable assignment syntax in CLI examples uses single quotes and parentheses, which may not work as shown in Bash on Linux/macOS. Additionally, PowerShell is always presented as an alternative, but no Bash-specific guidance or troubleshooting is provided, and CLI examples do not clarify cross-platform differences.
Recommendations
- Explicitly state that Azure CLI commands are cross-platform and provide Bash syntax for variable assignment (e.g., using arrays or comma-separated lists).
- Add notes or tabs for Bash/Linux/macOS users, clarifying any syntax differences for variables and command usage.
- Consider listing Azure CLI (Bash) examples first, as CLI is the recommended cross-platform tool.
- Where PowerShell is referenced, clarify that it is primarily for Windows users and provide equivalent Bash guidance if needed.
- Test and document any platform-specific issues with the CLI commands, especially variable assignment and quoting.
Create Pull Request