Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently presents PowerShell examples first and recommends running scripts in PowerShell locally using Visual Studio Code, which is a Windows-centric workflow. While Azure CLI examples are provided (which are cross-platform), there is no explicit mention or guidance for Linux/macOS environments, such as running scripts in native Linux terminals or using Bash. The documentation also references Azure Cloud Shell, which is cross-platform, but the local instructions and tooling are Windows-focused. No Linux-specific tools, shell environments, or troubleshooting notes are provided.
Recommendations
- Explicitly mention that Azure CLI commands can be run natively on Linux/macOS terminals, not just in Azure Cloud Shell.
- Provide Bash script examples or note that the CLI commands work in Bash and Zsh shells.
- Include guidance for installing and using Azure CLI on Linux/macOS, and clarify that Visual Studio Code is available cross-platform.
- Avoid recommending PowerShell locally as the default; present CLI and Bash examples first or in parallel.
- Add troubleshooting notes or tips for Linux/macOS users where workflows or UI may differ.
Create Pull Request