Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates Windows bias primarily in the 'Next steps' section, where Azure PowerShell and Visual Studio Code (a tool often associated with Windows) are mentioned before or instead of Linux-native alternatives. There are no explicit Linux CLI examples, and the guidance to use Azure CLI is coupled with Azure PowerShell, with no Linux-specific instructions or parity. The Bicep code example itself is platform-neutral, but the surrounding guidance assumes a Windows-centric workflow.
Recommendations
- Provide explicit Linux and macOS instructions for deploying Bicep files, including terminal commands using Azure CLI.
- Mention and link to Linux-native editors (such as Vim, Emacs, or VS Code on Linux) for creating Bicep files.
- Ensure that Azure CLI (which is cross-platform) is given equal or higher prominence than Azure PowerShell in deployment instructions.
- Add a section or note clarifying that all examples and tools are available and supported on Linux, with links to relevant installation guides.
- Where possible, include screenshots or terminal output from Linux environments to demonstrate parity.
Create Pull Request