Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Azure CLI and PowerShell examples for all major steps, but PowerShell is given equal prominence as CLI, and is referenced throughout. PowerShell is a Windows-centric tool, and its inclusion as a primary method (alongside CLI) can indicate a Windows bias, especially since PowerShell is still more commonly used on Windows. Additionally, deployment instructions for ARM templates mention PowerShell (New-AzResourceGroupDeployment) before CLI in some places, and PowerShell modules are referenced directly. There are no explicit Linux/macOS-only examples or notes, and no mention of Bash scripting or Linux-native tools. However, the Azure CLI examples are cross-platform and shown first in each tab set, which helps mitigate bias.
Recommendations
- Clarify that Azure CLI is fully cross-platform and recommend it as the default for Linux/macOS users.
- Add explicit notes or callouts for Linux/macOS users, such as installation instructions for Azure CLI on those platforms.
- Include Bash script examples or usage patterns where appropriate.
- De-emphasize PowerShell as a primary method, or clarify its cross-platform availability (PowerShell Core), but note that CLI is more common on Linux/macOS.
- Ensure that all deployment instructions (e.g., for ARM templates) show CLI commands before PowerShell, or provide parity in ordering.
Create Pull Request