Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation consistently provides examples for Azure CLI and Azure PowerShell, but omits explicit Linux/macOS shell examples. PowerShell is a Windows-centric tool, and its usage is shown alongside Azure CLI throughout. Additionally, instructions for setting up the environment reference Visual Studio and Visual Studio Code, which are available cross-platform but are more commonly associated with Windows. No Bash or shell script examples are provided, and there is no mention of Linux-specific patterns or tools.
Recommendations
- Add Bash (Linux/macOS) shell examples for all Azure CLI commands, showing usage with standard shell variable syntax (e.g., export, $VAR, etc.).
- Clarify that Azure CLI commands work cross-platform and provide explicit instructions for Linux/macOS users (e.g., using bash, zsh, etc.).
- Mention Linux-native editors (e.g., Vim, nano) as alternatives to Visual Studio Code and Visual Studio.
- Include notes about installing Azure CLI and Bicep CLI on Linux/macOS, with links to relevant documentation.
- Ensure that PowerShell is not presented as the default or only scripting option, and clarify its cross-platform availability.
Create Pull Request