Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently presents PowerShell as the primary scripting example and recommends running scripts in PowerShell locally using Visual Studio Code, which is a Windows-centric workflow. Although Azure CLI examples are provided (which are cross-platform), PowerShell is always mentioned first and with more detail, and there are no explicit Linux/macOS shell examples or guidance for those environments. The instructions for running scripts locally focus on Windows tools and do not mention Linux/macOS alternatives, which may create friction for non-Windows users.
Recommendations
- Present Azure CLI examples before PowerShell, or alternate the order to avoid Windows-first bias.
- Explicitly mention that Azure CLI can be run natively on Linux/macOS and provide guidance for those platforms.
- Add Bash shell examples for ARM template deployment and other tasks, especially where PowerShell syntax is used.
- Avoid recommending Visual Studio Code with PowerShell as the default local environment; suggest alternatives like VS Code with Bash or native terminal for Linux/macOS.
- Include troubleshooting notes or tips for Linux/macOS users where workflows may differ.
Create Pull Request