Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a Windows bias in several areas. PowerShell is presented as the first and primary example for building the Bicep template, with Azure CLI only shown as an alternative. There are no explicit Linux or macOS-specific instructions or examples, and the use of Visual Studio Code is described without mention of platform-specific setup steps. The documentation does not provide parity for Linux users in terms of command-line usage, troubleshooting, or tool installation.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples, as Azure CLI is cross-platform.
- Include explicit instructions for Linux and macOS users, such as installation commands for Azure CLI and Bicep on those platforms.
- Add troubleshooting notes for common issues encountered on Linux/macOS (e.g., file permissions, path differences).
- Clarify that Visual Studio Code and its extensions are available on all major platforms, and provide installation links for Linux/macOS.
- Avoid using Windows-centric terminology (such as referencing PowerShell as the default) unless necessary, and ensure all steps are platform-neutral or provide alternatives.
Create Pull Request