Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation consistently presents Azure PowerShell examples alongside Azure CLI, but several critical operations (such as record set level resource locks) are only possible via PowerShell, which is most commonly used on Windows. Azure portal instructions are also given, but PowerShell is frequently mentioned first, and in some cases, exclusively. There is no mention of Linux/macOS-specific considerations, nor are alternative Linux-native tools or shell examples provided. This creates friction for Linux/macOS users, especially where PowerShell is required for functionality not available in the CLI or portal.
Recommendations
- Explicitly note PowerShell's cross-platform availability and provide installation guidance for Linux/macOS users.
- Where PowerShell is the only option, clarify that it can be installed and used on Linux/macOS, and link to official installation docs.
- Add bash/zsh shell examples where possible, especially for Azure CLI commands, to improve accessibility for Linux/macOS users.
- Indicate CLI/portal feature gaps and provide workarounds or alternatives for non-Windows users.
- Consider the order of examples: present CLI and portal instructions before PowerShell to reduce perceived Windows bias.
Create Pull Request