Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways. When listing options for creating queues and topics/subscriptions, PowerShell is mentioned explicitly and before the CLI, which is more cross-platform. There are direct links to PowerShell instructions, but no mention of Bash or Linux-specific tools. No Linux shell examples or references to Linux-native patterns are provided, and the documentation does not clarify that the CLI is cross-platform or provide parity in example coverage for Linux users.
Recommendations
- Explicitly mention that the Azure CLI is cross-platform and suitable for Linux, macOS, and Windows.
- Provide Bash/Linux shell examples alongside PowerShell examples, or at least link to Linux-specific quickstarts.
- When listing creation options, avoid listing PowerShell before CLI, or alternate the order to avoid implicit prioritization.
- Include references to Linux-native automation tools (e.g., bash scripts, cron jobs) where relevant.
- Add a note clarifying that all features are available on Linux and macOS, not just Windows.
- Ensure parity in documentation links: if PowerShell is linked, also link to Bash/CLI equivalents.
Create Pull Request