Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by frequently mentioning Windows-specific tools and patterns (such as Azure PowerShell and Visual Studio Code commands with Windows keybindings), listing Windows options before Linux equivalents, and omitting explicit Linux-focused examples or alternatives. Azure PowerShell is referenced alongside Azure CLI, but Linux-specific shell usage (e.g., Bash) is not discussed. Keybindings are described as 'Ctrl+Shift+P on Windows and Linux,' but no Linux terminal examples are provided. Resource export examples and troubleshooting steps reference Windows-centric extensions and tools, with no mention of Linux-native workflows.
Recommendations
- Provide explicit Linux shell (Bash) examples for resource export and Bicep operations, alongside Azure CLI and PowerShell.
- List Azure CLI (cross-platform) before Azure PowerShell when presenting options, or present them together without ordering bias.
- Include Linux-specific troubleshooting steps and workflows, such as using native editors (e.g., Vim, nano) and command-line utilities.
- Add examples of using Bicep tooling in Linux environments, including installation and usage from Bash.
- Clarify that Visual Studio Code keybindings are the same for Windows and Linux, but also mention alternative editors for Linux users.
- Reference Linux-native tools or patterns where applicable, such as using shell scripts for automation.
Create Pull Request