Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and PowerShell examples for deployment commands, but PowerShell is given equal or slightly more prominence, and there is no explicit mention of Linux-specific considerations or shell environments. The use of PowerShell (traditionally Windows-centric) is featured throughout, and examples do not clarify cross-platform compatibility or show Linux shell alternatives (e.g., Bash). There is no discussion of platform-specific differences, and the documentation assumes parity between CLI and PowerShell without addressing Linux user needs.
Recommendations
- Explicitly state that Azure CLI commands work cross-platform (Windows, Linux, macOS) and provide Bash-specific examples where syntax may differ (e.g., environment variable usage, quoting).
- Clarify that PowerShell Core is available on Linux/macOS, or provide links to installation instructions for non-Windows platforms.
- Add notes or sections highlighting any platform-specific differences or prerequisites for Linux users (e.g., authentication, file paths, shell syntax).
- Where PowerShell is shown, consider also showing equivalent Bash or shell script examples for common tasks.
- Ensure that references to Azure Cloud Shell mention both Bash and PowerShell environments, and clarify which is being used in examples.
Create Pull Request