Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides parallel examples for both Azure CLI and Azure PowerShell, but PowerShell (a Windows-centric tool) is given equal prominence and detail as Azure CLI. The use of PowerShell and references to its installation may create friction for Linux/macOS users, as PowerShell is less commonly used or pre-installed on those platforms. The documentation does not show explicit Linux shell examples (e.g., bash), and the ordering of examples sometimes places PowerShell before CLI. There are no Linux-specific commands or troubleshooting notes, and the portal instructions are platform-neutral.
Recommendations
- Clearly indicate that Azure CLI commands are cross-platform and preferred for Linux/macOS users.
- Provide bash-specific examples or notes for Linux users (e.g., variable syntax differences).
- Add troubleshooting notes for common Linux/macOS issues (e.g., CLI installation, environment variables).
- Consider listing Azure CLI examples before PowerShell, or grouping by platform relevance.
- Explicitly mention that PowerShell is available on Linux/macOS, but may require installation.
Create Pull Request