Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides deployment mode examples for both Azure PowerShell and Azure CLI, but PowerShell is presented first and uses a Windows-style file path (c:\MyTemplates\storage.json). There are no explicit Linux/macOS examples or notes about cross-platform usage, and the CLI example is shown after PowerShell. The documentation references Azure PowerShell and CLI together when discussing REST API versions, but does not clarify platform differences or provide parity guidance.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to avoid implicit Windows-first bias.
- Use platform-neutral file paths in examples (e.g., ./MyTemplates/storage.json) or provide both Windows and Linux/macOS variants.
- Explicitly mention that Azure CLI is cross-platform and provide guidance for Linux/macOS users where relevant.
- Ensure that links to further deployment documentation include both PowerShell and CLI options, and clarify platform compatibility.
- Add a note that both PowerShell and CLI commands can be run on Windows, Linux, and macOS, with installation links for each.
Create Pull Request