Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
Summary
The documentation provides examples for Azure Portal, Azure CLI, ARM Template, and PowerShell. PowerShell examples are given equal prominence to CLI, and PowerShell is a Windows-centric tool. In each major section (setting/updating policy, getting status, canceling, restarting), PowerShell examples are presented as a primary method alongside CLI, but there are no explicit Linux/macOS shell or scripting examples (e.g., Bash, Cloud Shell specifics). The CLI examples are cross-platform, but the presence and prominence of PowerShell throughout the documentation indicate a Windows bias. There is no mention of Linux-specific tooling or workflows, and PowerShell is listed before ARM Template in most cases.
Recommendations
- Clarify that Azure CLI commands work on Linux, macOS, and Windows equally, and consider showing Bash-specific usage (e.g., environment variables, piping, jq for JSON parsing).
- Add explicit Bash or shell script examples for common operations, especially for status checking and automation.
- Mention Azure Cloud Shell as a cross-platform option for both CLI and PowerShell, and clarify its OS-agnostic nature.
- If PowerShell is shown, note that PowerShell Core is available on Linux/macOS, or provide links/instructions for Linux/macOS users.
- Consider listing CLI (Bash) examples before PowerShell to reduce Windows-first perception.
Create Pull Request