Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation page focuses on Visual Studio, a Windows-centric IDE, and lists Visual Studio as the primary tool for Bicep authoring. While deployment and cleanup instructions include both Azure CLI and PowerShell examples, PowerShell is mentioned alongside CLI as a first-class option, and Visual Studio is presented before Visual Studio Code (which is cross-platform). There are no explicit Linux tool references, and the workflow assumes a Windows environment by default.
Recommendations
- Explicitly mention that Visual Studio Code is cross-platform and suitable for Linux and macOS users, possibly with a direct link in the prerequisites.
- Reorder or clarify the prerequisites to present Visual Studio Code as an equal alternative to Visual Studio, not as a secondary option.
- Add notes or sections highlighting Linux/macOS compatibility for Bicep authoring and deployment, including any differences in setup or usage.
- Ensure that CLI examples are presented before or alongside PowerShell examples, as Azure CLI is cross-platform.
- Consider including screenshots or instructions for Visual Studio Code in parallel with Visual Studio, or provide a side-by-side comparison for users on different platforms.
Create Pull Request