Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for Azure Portal, PowerShell, Azure CLI, and REST API. PowerShell is given equal prominence to Azure CLI, but PowerShell is a Windows-centric tool, and its examples are presented before Azure CLI in every section. There are no explicit Linux shell (bash) or scripting examples, and no mention of Linux-specific tools or patterns. The documentation assumes PowerShell is universally available, which may not be the case for Linux users. The use of PowerShell as a primary scripting example introduces a subtle Windows bias.
Recommendations
- Add bash/sh scripting examples alongside PowerShell, especially for scenarios where scripting is needed.
- Explicitly mention that Azure CLI works cross-platform (Windows, Linux, macOS) and highlight its parity.
- Consider presenting Azure CLI examples before PowerShell, or at least alternating their order.
- Include notes or links for installing PowerShell on Linux if PowerShell examples are retained.
- Where possible, reference Linux-native tools or patterns (e.g., jq for JSON parsing) in CLI examples.
- Clarify that PowerShell is not required for Linux users and that all operations can be performed with Azure CLI or REST API.
Create Pull Request