Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation references both Azure CLI and PowerShell for configuring retry policies and batching, but it consistently lists PowerShell alongside CLI, and refers to 'PowerShell command' without clarifying cross-platform support. The only explicit command-line example provided is for Azure CLI, which is cross-platform, but references to PowerShell are present without corresponding Linux shell (bash) or scripting examples. There are no explicit Linux- or macOS-specific instructions, nor are there any bash or shell script examples. The documentation does not mention platform-specific differences, but the pattern of referencing PowerShell and CLI together, and the absence of Linux-specific examples or notes, suggests a subtle Windows-first bias.
Recommendations
- When referencing PowerShell, clarify that Azure PowerShell is cross-platform, or provide equivalent bash/shell examples where appropriate.
- Include explicit bash or shell script examples for common Linux/macOS usage scenarios, especially where PowerShell is mentioned.
- When linking to further documentation (e.g., 'Set retry policy'), ensure that both PowerShell and bash/CLI examples are present and equally prominent.
- Avoid phrasing such as 'CLI and PowerShell' as the only options; mention bash/shell scripting or note that Azure CLI works on all platforms.
- Add a note or section on platform compatibility for all command-line tools referenced, making it clear that Linux/macOS users are equally supported.
Create Pull Request