Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for programmatic management, but PowerShell examples are consistently present and sometimes shown first, especially in advanced scenarios. There is a notable emphasis on PowerShell for scripting, which is more commonly used on Windows. No Linux-specific tools or shell scripting examples (e.g., Bash) are provided, and the documentation does not mention platform-specific differences or considerations for Linux/macOS users. However, Azure CLI is cross-platform and included in all relevant sections, mitigating most friction.
Recommendations
- Ensure Azure CLI examples are always shown before PowerShell, as CLI is cross-platform.
- Add explicit notes that Azure CLI works on Linux/macOS and Windows, while PowerShell is primarily Windows (with cross-platform support, but less common on Linux).
- Consider including Bash script examples for common tasks, or at least reference that Azure CLI commands can be used in Bash/zsh shells.
- Add a brief section clarifying that all programmatic examples (except PowerShell) are platform-agnostic, and highlight any platform-specific caveats if they exist.
- Where PowerShell is used for advanced scenarios, provide equivalent Azure CLI or REST API examples if possible.
Create Pull Request