Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides both Bash (Azure CLI) and PowerShell examples for all command-line operations, ensuring Linux parity in terms of functionality. However, PowerShell examples are given equal prominence to Bash, and in some cases, PowerShell-specific Azure modules are referenced. There is a slight Windows bias in that PowerShell is featured as a first-class citizen alongside Bash, which is more common on Linux/macOS. No critical sections are Windows-only, and Linux/macOS users can complete all tasks using Bash/Azure CLI.
Recommendations
- Consider listing Bash/Azure CLI examples before PowerShell examples to reflect the prevalence of Bash on Linux/macOS.
- Clearly indicate that PowerShell examples are primarily for Windows users, while Bash/Azure CLI is cross-platform.
- Add a note clarifying that all Azure CLI commands work on Linux, macOS, and Windows, while PowerShell commands require PowerShell Core or Windows PowerShell.
- Ensure that any references to Azure PowerShell modules include installation instructions for Linux/macOS if relevant.
Create Pull Request