Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a strong Windows bias by exclusively using PowerShell scripting for automation, referencing Windows-specific installation links for both Azure PowerShell and Azure CLI, and omitting any Linux or cross-platform shell examples (such as Bash). All code samples are written in PowerShell, with no mention of how to perform the same tasks on Linux or macOS. The prerequisite checks and scripting patterns assume a Windows environment, potentially alienating users on other platforms.
Recommendations
- Provide equivalent Bash shell examples for all automation steps, demonstrating how to use Azure CLI commands in a cross-platform manner.
- Include installation instructions and links for Azure PowerShell and Azure CLI for Linux and macOS, not just Windows.
- Clearly state that Azure CLI is cross-platform and can be used from Bash, zsh, or other shells, and show how to check prerequisites on Linux/macOS (e.g., 'az --version', 'pwsh --version').
- Offer guidance on running scripts in non-Windows environments, such as using Bash scripts or PowerShell Core (pwsh) on Linux/macOS.
- Consider restructuring the documentation so that Windows and Linux/macOS instructions/examples are presented side-by-side or in separate tabs for parity.
Create Pull Request