Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page exclusively uses PowerShell cmdlets for all troubleshooting steps, with no examples or guidance for Linux/macOS users using Bash or Azure CLI. The prerequisites and instructions assume familiarity with PowerShell, which is traditionally a Windows-centric tool, and there is no mention of equivalent CLI commands within the main content. Although Azure Cloud Shell supports PowerShell on all platforms, the lack of Bash/CLI examples creates friction for users on Linux or macOS who may prefer or expect non-PowerShell workflows.
Recommendations
- Add equivalent Azure CLI (az) examples alongside PowerShell for all troubleshooting steps.
- Explicitly mention that Azure Cloud Shell supports Bash and provide instructions/examples for Bash users.
- Reorder prerequisites and instructions to present both PowerShell and CLI options equally, rather than PowerShell-first.
- Include a note clarifying cross-platform support and linking to CLI documentation directly in relevant sections, not just in 'Related content'.
Create Pull Request