Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for all steps, but the PowerShell examples are given equal prominence and detail as the CLI, despite PowerShell being primarily a Windows-centric tool. The prerequisites mention Azure PowerShell before Azure CLI, and the custom metadata ('devx-track-azurepowershell') suggests a PowerShell focus. There are no Linux-specific shell examples (e.g., bash-only, or Linux-native tools), and PowerShell is not natively available on most Linux distributions. However, the Azure CLI examples are fully cross-platform and shown first in each section, mitigating the bias.
Recommendations
- Clarify that Azure CLI is fully cross-platform and preferred for Linux/macOS users.
- Add a note that PowerShell is available for Linux, but CLI is more commonly used on Linux/macOS.
- Consider including bash-only or Linux-native shell examples for scripting tasks, especially for disk management.
- Remove or balance metadata and authoring cues that suggest PowerShell is the primary method.
- Explicitly state that all CLI examples work on Linux/macOS, and link to installation guides for those platforms.
Create Pull Request