Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for all key operations, ensuring cross-platform coverage. However, PowerShell examples are consistently presented before CLI examples in every section, and the narrative often refers to 'PowerShell or CLI' in that order. There are no Linux/macOS-specific examples, nor are there any references to platform-specific tooling or shell differences. The documentation does not mention Linux or macOS explicitly, nor does it address any platform-specific considerations for running Azure CLI or PowerShell commands.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first in some sections to avoid implicit prioritization of Windows tools.
- Explicitly state that Azure CLI works natively on Linux/macOS and that PowerShell Core is cross-platform, to reassure non-Windows users.
- Add a brief note or section on platform compatibility, including any prerequisites or differences for Linux/macOS users (e.g., installation, file paths, shell syntax).
- Consider including Bash script snippets or references to shell environments common on Linux/macOS where appropriate.
- Avoid language that implies PowerShell is the default or preferred tool unless justified by functionality.
Create Pull Request