Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation consistently presents Azure PowerShell examples before Azure CLI examples, and references PowerShell scripts and usage patterns throughout. There is a notable emphasis on PowerShell as a deployment tool, and PowerShell-specific instructions are given for tasks such as creating, viewing, and deploying template specs. No Linux/macOS-specific shell examples (e.g., Bash) or platform-specific notes are provided, and the CLI examples are generic, not tailored to Linux/macOS environments.
Recommendations
- Alternate the order of examples so that Azure CLI (cross-platform) is shown before PowerShell in some sections.
- Explicitly mention that Azure CLI commands work on Linux/macOS and provide platform-specific notes or tips where relevant (e.g., file paths, environment variables).
- Include Bash or shell script examples for common tasks, especially for automation scenarios.
- Clarify that PowerShell is available cross-platform, but highlight any differences or limitations on Linux/macOS.
- Add troubleshooting or installation notes for Linux/macOS users where PowerShell is referenced.
- Avoid language that implies PowerShell is the default or preferred tool unless justified by functionality.
Create Pull Request