Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by consistently providing Azure PowerShell examples alongside Azure CLI, referencing Windows-centric tools (Visual Studio, Visual Studio Code), and omitting explicit Linux/macOS shell examples. There is no mention of Bash, zsh, or Linux-specific patterns, and the guidance assumes familiarity with PowerShell syntax and Windows-based development environments. The order of examples often places PowerShell immediately after CLI, reinforcing Windows-first patterns.
Recommendations
- Add explicit Bash/zsh examples for all CLI commands, showing syntax differences (e.g., variable assignment, quoting).
- Include instructions for installing and using Bicep CLI and Azure CLI on Linux/macOS, with links to platform-specific guides.
- Mention cross-platform editors such as VS Code for Linux/macOS, and clarify that Visual Studio is Windows-only.
- Where PowerShell is referenced, clarify its cross-platform availability or provide alternative shell instructions.
- Ensure screenshots and step-by-step instructions do not assume a Windows environment (e.g., file paths, UI elements).
- Add a section or note highlighting Linux/macOS compatibility and any platform-specific caveats.
Create Pull Request