Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides command-line build instructions for Bicep files using both PowerShell and Azure CLI, but the PowerShell example is presented first and explicitly labeled, while the Azure CLI example is shown second. There are no Linux/macOS-specific instructions or examples for tasks such as installing prerequisites, using the Azure portal, or verifying deployment. The documentation assumes Visual Studio Code as the editor, which is cross-platform, but does not mention any Linux/macOS-specific considerations or alternative editors. All portal instructions are platform-neutral, but command-line examples and tool mentions lean toward Windows-first presentation.
Recommendations
- Present Azure CLI examples before or alongside PowerShell examples, as Azure CLI is cross-platform.
- Explicitly mention that all command-line instructions work on Linux/macOS, and provide any necessary platform-specific notes (e.g., installation commands, path differences).
- Include Linux/macOS-specific installation instructions for Azure CLI and Bicep, or link to them.
- Clarify that Visual Studio Code is available on Linux/macOS and mention alternative editors if relevant.
- Add a note that all portal-based steps are platform-agnostic.
Create Pull Request