Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently providing Azure PowerShell examples alongside Azure CLI, referencing Windows-centric tools (Visual Studio, Visual Studio Code), and omitting explicit Linux/macOS shell examples (e.g., Bash). The instructions and screenshots focus on Visual Studio Code and Visual Studio, which are more commonly used on Windows, and do not mention Linux-native editors or shell usage. There is no guidance for Linux-specific environments, nor are there examples using Bash or other Linux command-line conventions.
Recommendations
- Add explicit Bash shell examples for all Azure CLI commands, showing Linux/macOS syntax (e.g., export, $VAR, file paths with /).
- Include instructions for using Bicep CLI and Azure CLI in Linux/macOS terminals, noting any differences in environment setup or file paths.
- Mention Linux-native editors such as Vim, Emacs, or GNOME Text Editor as alternatives to Visual Studio Code.
- Clarify that Visual Studio Code is cross-platform and provide installation guidance for Linux/macOS.
- Add notes about running Azure CLI and Bicep CLI on Linux/macOS, including package manager installation commands (apt, yum, brew).
- Ensure screenshots and examples do not assume a Windows environment (e.g., avoid Windows-style file paths, PowerShell variables).
Create Pull Request