Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides parallel examples for Azure CLI (Bash) and Azure PowerShell throughout, but there are several signs of Windows bias. PowerShell examples and references (including .ps1 scripts and PowerShell-specific variables and tools) are given equal or greater prominence, and Windows/PowerShell-specific concepts (such as Connect-AzAccount, $ErrorActionPreference, Start-Sleep, and CommandLineToArgvW) are referenced without Linux/macOS equivalents or context. The documentation sometimes references Windows APIs (CommandLineToArgvW) and PowerShell cmdlets before or without mentioning Linux alternatives. However, most tasks can be completed using either CLI or PowerShell, and the CLI examples use Bash syntax compatible with Linux/macOS.
Recommendations
- When referencing system calls or APIs (e.g., CommandLineToArgvW), clarify their relevance to Linux/macOS or provide equivalent context.
- Ensure that CLI (Bash) examples are shown first or equally, especially for generic scripting tasks.
- Where PowerShell-specific troubleshooting or error handling is discussed, provide Bash/Linux equivalents (e.g., set -e, trap, etc.).
- Avoid referencing Windows-specific tools or APIs without mentioning cross-platform alternatives.
- Explicitly state that both Bash (CLI) and PowerShell approaches are supported on Linux/macOS and Windows, and clarify any platform-specific limitations.
Create Pull Request