Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page exhibits mild Windows bias in its tooling and example ordering. While both Azure PowerShell and Azure CLI are mentioned as options for building the Bicep template, PowerShell is presented first and more prominently. There are no explicit Linux/macOS-specific instructions or screenshots, and the prerequisites and workflow focus on tools (Visual Studio Code, Azure CLI, PowerShell) that are cross-platform but do not clarify Linux/macOS nuances. No Linux-specific shell examples (e.g., Bash) are provided, and portal instructions are generic. The lack of explicit Linux/macOS parity may cause minor friction for non-Windows users.
Recommendations
- Present Azure CLI and PowerShell examples side-by-side, or default to Azure CLI first, as it is platform-neutral.
- Explicitly mention that all steps (including Visual Studio Code and Azure CLI) work on Linux/macOS, and provide any OS-specific caveats if relevant.
- Include screenshots or terminal examples from Linux/macOS environments to reinforce cross-platform support.
- Add a note in the prerequisites clarifying that PowerShell Core is available on Linux/macOS, or recommend Azure CLI for those platforms.
- Where possible, provide Bash shell equivalents for command-line steps.
Create Pull Request