Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently presenting Azure PowerShell examples before Azure CLI, and in some cases, only providing PowerShell commands (e.g., record set level resource locks). There are no Linux-specific examples, nor is there mention of Linux-native tools or shell scripting patterns. The reliance on PowerShell (traditionally a Windows tool) and the lack of parity for features in Azure CLI or portal (which are more cross-platform) further reinforce the bias.
Recommendations
- Ensure all features and scenarios have Azure CLI examples, especially where currently only PowerShell is documented.
- Explicitly state platform limitations (e.g., if a feature is only available in PowerShell, clarify whether this is due to backend limitations or tooling gaps).
- Where PowerShell is used, provide equivalent bash/shell scripting examples for Linux users.
- Highlight cross-platform usage and recommend CLI or REST API approaches where possible.
- Add notes or guidance for Linux/macOS users, including installation and usage of Azure CLI.
- Consider reordering examples so that CLI (cross-platform) appears before PowerShell, or present both together.
Create Pull Request