Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents both Azure CLI and Azure PowerShell examples for deployment and cleanup, but PowerShell is mentioned as a primary tool in the prerequisites and is given equal prominence in all code tabs. Visual Studio Code is recommended as the editor, which is cross-platform, but the overall pattern leans toward Windows-centric tools and workflows, with no explicit mention of Linux-specific alternatives or shell environments (e.g., Bash). There are no Linux-specific examples, nor is there guidance for Linux users regarding shell syntax or environment setup.
Recommendations
- Explicitly mention that Azure CLI commands work in Bash and other Linux shells, and provide example commands using Bash syntax (e.g., export instead of variable assignment with =).
- Add a note in the prerequisites about using Bicep and Azure CLI on Linux and macOS, with links to installation guides for those platforms.
- Consider including a Linux shell tab alongside CLI and PowerShell, showing Bash-style variable assignment and command usage.
- Clarify that Visual Studio Code and the Bicep extension are available on Linux and macOS, and mention alternative editors if relevant.
- Ensure that references to PowerShell do not imply it is the default or preferred method, and balance with Linux-native tooling.
Create Pull Request