Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment, resource review, and cleanup, but PowerShell (a Windows-centric tool) is consistently presented as an equal alternative to CLI, and sometimes appears before or alongside CLI. There are no Linux-specific shell examples (e.g., Bash scripts), nor is there mention of Linux-native tools or workflows. The documentation does not reference Linux-specific patterns or troubleshooting, and the use of PowerShell may imply a Windows bias, especially for users unfamiliar with it.
Recommendations
- Explicitly state that Azure CLI commands work natively on Linux, macOS, and Windows, while PowerShell is primarily for Windows (though available cross-platform).
- Provide Bash script examples for Linux users, especially for steps involving file manipulation or automation.
- Clarify prerequisites for running PowerShell on non-Windows platforms, or link to installation instructions for PowerShell Core on Linux/macOS.
- Add troubleshooting notes or tips relevant to Linux environments (e.g., file permissions, SSH key generation).
- Consider listing CLI (Bash) examples before PowerShell to reflect the cross-platform nature of Azure CLI.
Create Pull Request