Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Summary
The documentation page demonstrates a Windows bias by consistently listing Azure PowerShell instructions before Azure CLI, providing detailed PowerShell command examples, and referencing Windows-centric tools and patterns (e.g., PowerShell cmdlets, screenshots of the Azure portal, and terminology familiar to Windows administrators). Linux-specific patterns, shell examples, or screenshots are absent, and the CLI instructions are less detailed. There is no mention of Linux-native tooling or shell scripting, nor any guidance for Linux users beyond the generic Azure CLI commands.
Recommendations
- Alternate the order of PowerShell and CLI instructions, or present CLI examples first to avoid implicit prioritization of Windows tools.
- Expand CLI sections to include more detailed output examples and troubleshooting steps, matching the depth of PowerShell coverage.
- Include Linux shell scripting examples (e.g., bash scripts for feature registration and status checks) alongside PowerShell.
- Add screenshots or walkthroughs using Azure CLI in a Linux terminal, not just the Azure portal.
- Reference Linux-native tools and workflows where applicable, such as using curl for REST API calls or jq for output parsing.
- Explicitly state that all features and steps are supported on Linux, and provide links to Linux-specific guidance where available.