Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples for deployment commands, but PowerShell is consistently presented as the second option after Azure CLI. There are no explicit Linux shell (bash) examples, nor are there any references to Linux-specific tools or scripting environments. The use of PowerShell (which is traditionally associated with Windows, though now cross-platform) is prominent, and there is no mention of Linux-native scripting or automation approaches. The documentation does not clarify that Azure CLI commands are cross-platform, nor does it provide bash-specific guidance or troubleshooting.
Recommendations
- Explicitly state that Azure CLI commands are cross-platform and can be run on Windows, Linux, and macOS.
- Add bash-specific examples or notes, especially for parameter passing and environment variable usage, to address common Linux shell scenarios.
- Include troubleshooting tips or links for common issues encountered on Linux (e.g., line endings, quoting differences).
- Consider providing examples using native Linux tools (e.g., curl for REST API calls) where relevant.
- Reorder sections or alternate the order of CLI and PowerShell examples to avoid implicit prioritization of Windows tools.
- Clarify that PowerShell Core is available on Linux and macOS, if PowerShell examples are retained.
Create Pull Request