Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides command-line examples exclusively for Azure CLI and Azure PowerShell, with PowerShell examples given equal prominence to Azure CLI. There are no Linux/macOS-specific shell examples (e.g., Bash), and PowerShell is a Windows-centric tool, though it is available cross-platform. The documentation also references Visual Studio and Visual Studio Code, which are available on Windows and macOS, but does not mention Linux-specific editors or workflows. The ordering of examples sometimes places PowerShell before CLI, and there is no explicit guidance for Linux users regarding shell syntax, environment setup, or alternative tools.
Recommendations
- Add Bash shell examples for all CLI commands to demonstrate usage on Linux/macOS.
- Clarify that Azure CLI commands can be run in Bash, Zsh, and other Linux/macOS shells.
- Mention Linux-native editors (e.g., Vim, nano) or provide guidance for using VS Code on Linux.
- Explicitly state cross-platform compatibility for Bicep CLI and Azure CLI.
- Avoid presenting PowerShell as the default or only scripting option; make CLI/Bash examples primary.
- Add notes about environment setup for Linux/macOS, such as package managers and installation steps.
Create Pull Request