Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page primarily references Windows-centric tools and workflows, such as Azure PowerShell and Visual Studio Code, and does not provide Linux-specific examples or mention Linux-native tools. The 'Next steps' section lists Azure PowerShell before Azure CLI and only references Visual Studio Code, which may suggest a Windows-first approach. There are no explicit Linux or cross-platform command-line examples or editor recommendations.
Recommendations
- In the 'Next steps' section, list Azure CLI before Azure PowerShell or mention both equally to avoid implying a Windows-first workflow.
- Include explicit instructions or links for deploying Bicep files from Linux/macOS terminals using Azure CLI.
- Mention alternative editors that are popular on Linux, such as Visual Studio Code (which is cross-platform), Vim, or other code editors.
- Where possible, provide cross-platform command-line examples and clarify that Bicep and Azure CLI are fully supported on Linux and macOS.
- Add a note or section highlighting that all examples work identically on Linux, macOS, and Windows, and provide troubleshooting links for each platform.
Create Pull Request