Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for deployment and cleanup, but PowerShell examples are consistently presented alongside CLI, and Visual Studio Code is the only editor mentioned for Bicep authoring. There is a slight 'windows_first' bias in the prerequisites, as Visual Studio Code and its extension are referenced before CLI/PowerShell, and PowerShell is given equal prominence to CLI throughout, which may not be necessary for Linux/macOS users. No Linux/macOS-specific shell or editor guidance is provided, but CLI examples are cross-platform.
Recommendations
- Explicitly state that Azure CLI commands work on Linux/macOS and Windows, while PowerShell is primarily for Windows.
- Add guidance for using other editors (e.g., Vim, Sublime Text) for Bicep authoring on Linux/macOS.
- Consider listing Azure CLI examples first, as it is cross-platform, and clarify that PowerShell is optional for Windows users.
- Provide a brief note on how to install Bicep and Azure CLI on Linux/macOS, or link to platform-specific instructions.
- Mention that Visual Studio Code is available on Linux/macOS, but users can use any text editor.
Create Pull Request