Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. PowerShell is presented as the first and primary example for building Bicep files, with Azure CLI as a secondary option. There are no explicit Linux/macOS instructions or screenshots, and the workflow assumes familiarity with Windows-centric tools (e.g., Visual Studio Code, PowerShell). The portal instructions and screenshots do not address cross-platform differences, and there is no mention of Linux-specific considerations or alternative editors.
Recommendations
- Present Azure CLI examples before or alongside PowerShell, as CLI is cross-platform.
- Explicitly mention that all CLI commands work on Linux/macOS and Windows, and provide any OS-specific notes if needed.
- Include screenshots or instructions for Linux/macOS environments where UI or tool behavior may differ.
- Suggest alternative editors (e.g., VS Code is cross-platform, but mention alternatives like Vim, nano, etc. for Linux users).
- Add a section or callout for Linux/macOS users, confirming parity and noting any differences in setup or workflow.
- Avoid language that implies Windows is the default platform (e.g., avoid 'open PowerShell' as the only shell option).
Create Pull Request