Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation consistently provides both Azure PowerShell and Azure CLI examples for all commands and deployment steps. However, Azure PowerShell (a Windows-centric tool) is always listed first, and its usage is emphasized equally alongside Azure CLI, despite the CLI being cross-platform and more native to Linux environments. There are no explicit Linux-specific examples, nor are Linux shell patterns (e.g., bash scripting, environment variables) discussed. The documentation does not mention Linux tools or workflows, and there is no guidance for users who may be working exclusively in Linux environments.
Recommendations
- Alternate the order of examples so that Azure CLI commands are listed before PowerShell in some sections, or default to CLI first as it is cross-platform.
- Explicitly mention that Azure CLI works natively on Linux, macOS, and Windows, while Azure PowerShell is most commonly used on Windows.
- Add Linux shell scripting examples (e.g., using bash, exporting variables, chaining commands) to demonstrate Linux-native workflows.
- Provide guidance or links for installing and using Azure CLI on Linux systems.
- Consider including a note for users who may not have PowerShell available, highlighting CLI as the recommended option for Linux.
Create Pull Request