Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
minor_shell_inconsistency
Summary
The documentation provides both Azure CLI (cross-platform) and Azure PowerShell (Windows-centric) examples in parallel throughout, but frequently lists PowerShell examples after CLI. However, some shell commands (such as kubectl and environment variable usage) are shown in a way that is more natural for Bash/Linux, even in PowerShell sections. There is no exclusive use of Windows tools, but the presence of PowerShell examples may suggest a slight Windows bias, and some shell commands (like echo $TOKEN) are not idiomatic PowerShell.
Recommendations
- Clarify that Azure CLI examples are fully supported on Linux/macOS and are the recommended cross-platform approach.
- Consider removing or de-emphasizing PowerShell examples unless there is a Windows-specific workflow.
- Ensure shell commands in PowerShell sections use proper PowerShell syntax (e.g., Write-Output instead of echo).
- Add explicit notes about Linux/macOS compatibility where appropriate.
- If possible, provide a single set of CLI examples with notes for platform-specific differences, rather than duplicating for PowerShell.
Create Pull Request