Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for all major operations, but PowerShell (traditionally associated with Windows) is consistently presented before CLI in tab order and example sections. PowerShell prerequisites and commands are described in detail, sometimes with more context than CLI. There are no explicit Linux/macOS-only examples or troubleshooting notes, and no mention of Linux-specific shell patterns or issues. However, CLI instructions (which run natively on Linux/macOS) are present and complete, and Cloud Shell is highlighted as a Bash environment.
Recommendations
- Alternate the order of PowerShell and CLI tabs/examples so CLI is sometimes presented first, especially for cross-platform parity.
- Explicitly mention that Azure CLI commands work on Linux/macOS and provide links or notes for installing CLI on those platforms.
- Add troubleshooting notes or tips for Linux/macOS users (e.g., file permissions, shell differences) where relevant.
- Include references to Linux-native tools or patterns where possible (e.g., using Bash scripting for automation).
- Clarify that PowerShell Core is available on Linux/macOS, if PowerShell is required, and provide installation links.
Create Pull Request