Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page demonstrates mild Windows bias. Azure PowerShell is mentioned alongside Azure CLI in prerequisites and deployment/cleanup instructions, but examples and instructions are given for both. However, PowerShell is a Windows-centric tool, and its mention before Linux-native alternatives (like Bash) can signal Windows-first thinking. The Visual Studio Code workflow is cross-platform, but there is no explicit mention of Linux or MacOS environments, nor are there any examples tailored for those platforms (e.g., terminal commands, OS-specific notes). No Linux-specific tools or patterns are discussed, and the documentation does not acknowledge platform-specific differences in experience or setup.
Recommendations
- Explicitly state that Visual Studio Code and the Bicep extension work on Windows, Linux, and MacOS.
- Add screenshots or notes showing the workflow on Linux and MacOS (e.g., using the terminal, file explorer differences).
- Include Bash examples for deploying and cleaning up resources, not just Azure CLI (which is cross-platform, but Bash syntax is familiar to Linux users).
- Clarify that Azure PowerShell is available on Linux and MacOS, or recommend Bash/Azure CLI as the default for Linux users.
- Add troubleshooting tips for Linux/MacOS users (e.g., permissions, path issues, installing prerequisites).
- Avoid listing PowerShell before CLI or Bash unless contextually appropriate for the majority of users.
Create Pull Request