Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page references Azure CLI and Azure PowerShell together for running examples, but lists Azure PowerShell (a Windows-centric tool) before Azure CLI, which is cross-platform. The guidance for creating Bicep files only mentions Visual Studio Code, which is available on Linux but is often associated with Windows development. There are no explicit Linux shell or deployment examples, and no mention of Linux-native tools or workflows. No Linux-specific instructions or parity examples are provided.
Recommendations
- List Azure CLI before Azure PowerShell when suggesting deployment tools, as Azure CLI is more platform-neutral.
- Explicitly mention that all examples can be run on Linux, macOS, and Windows, and provide a Linux shell (bash) example for deploying Bicep files.
- Include instructions or links for using Bicep with Linux-native editors (e.g., Vim, Emacs) or command-line workflows.
- Clarify that Visual Studio Code is available on Linux and macOS, or suggest alternative editors for non-Windows users.
- Ensure that all tool references and workflows are presented in a platform-neutral order and language.
Create Pull Request