Bias Analysis
Detected Bias Types
windows_first
missing_linux_example
Summary
The documentation is heavily focused on Visual Studio, a Windows-centric IDE, and does not provide Linux/macOS equivalents for authoring Bicep files. While deployment instructions include both Azure CLI and PowerShell, the authoring workflow is only described for Visual Studio, with Linux-friendly alternatives relegated to a 'Next steps' link. There are no explicit Linux/macOS instructions or screenshots, and the prerequisites and workflow assume Windows usage.
Recommendations
- Include parallel instructions and screenshots for Visual Studio Code, which is cross-platform, within this page rather than only in a separate link.
- Explicitly mention that Visual Studio is Windows-only and direct Linux/macOS users to Visual Studio Code in the prerequisites section.
- Add a table or section comparing authoring options for Windows, Linux, and macOS, with links to relevant setup guides.
- Ensure all CLI commands are shown first or equally with PowerShell, and clarify that PowerShell is primarily for Windows users.
- Add notes or callouts for Linux/macOS users throughout the workflow, especially in the prerequisites and authoring steps.
Create Pull Request