Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and Azure PowerShell examples throughout, with PowerShell examples clearly labeled and separated. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI, and in some sections (such as prerequisites), PowerShell examples are shown immediately after CLI, sometimes without explicit Linux/macOS guidance. There are no Linux-specific examples or explicit mentions of Linux/macOS compatibility for PowerShell commands. The documentation does not use Windows-only tools, but the inclusion of PowerShell may cause confusion for Linux/macOS users, especially since PowerShell is not pre-installed on those platforms.
Recommendations
- Clarify that Azure PowerShell examples are primarily for Windows users, and that Azure CLI is cross-platform (Linux/macOS/Windows).
- Add explicit notes or tabs indicating which examples are suitable for Linux/macOS users.
- Consider providing Bash shell examples where relevant, especially for commands involving environment variables.
- Mention that PowerShell is available for Linux/macOS, but CLI is the recommended tool for those platforms.
- Ensure that all critical steps can be completed using Azure CLI, and highlight CLI as the default for cross-platform users.
Create Pull Request