Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure PowerShell and Azure CLI examples for all major operations, but consistently lists PowerShell (a Windows-centric tool) examples before CLI, and uses PowerShell-specific notes and recommendations. There is no explicit mention of Linux/macOS environments, nor are there examples using Bash, shell scripting, or platform-specific CLI nuances. The documentation assumes parity between CLI and PowerShell, but the ordering and emphasis favor Windows users.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to better support cross-platform users.
- Add explicit notes confirming that Azure CLI commands work identically on Linux, macOS, and Windows, and clarify any platform-specific differences if they exist.
- Include example shell scripts (Bash) for common tasks, especially for parameter passing and file handling.
- Add a section or note about installing and using Azure CLI on Linux/macOS, with links to official installation guides.
- Avoid PowerShell-specific recommendations unless there is a functional difference; otherwise, generalize instructions to cover all platforms.
Create Pull Request