Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for most operations, but PowerShell is given equal or greater prominence, and some PowerShell examples use Windows-specific syntax (e.g., variable assignment with $var=). There is no explicit mention of Linux or macOS environments, nor are there Bash-specific examples or notes about differences in command usage between platforms. The PowerShell examples are not clearly marked as cross-platform (PowerShell Core), and there are no Linux shell (bash) or macOS-specific instructions, which may disadvantage non-Windows users.
Recommendations
- Clearly indicate when PowerShell examples are compatible with PowerShell Core on Linux/macOS, or provide separate notes if there are differences.
- Provide explicit Bash shell examples for Azure CLI commands, especially where variable assignment or command syntax may differ between Windows (cmd/PowerShell) and Linux/macOS (bash/zsh).
- Add a section or callout clarifying that Azure CLI is fully cross-platform and can be used on Linux, macOS, and Windows, and provide links to installation instructions for each OS.
- Where PowerShell is presented, ensure that it is not assumed to be the default or primary automation tool, and avoid using Windows-specific idioms unless necessary.
- Include troubleshooting or environment setup notes for Linux/macOS users, such as authentication differences or file path conventions.
Create Pull Request