Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents both Azure CLI (Bash) and PowerShell examples for deploying ARM templates in Cloud Shell, but PowerShell (a Windows-centric tool) is consistently mentioned alongside or immediately after Bash. Visuals and instructions frequently reference toggling between Bash and PowerShell, and 'PowerShell' is often listed first or equally with Bash, despite Bash being the default and more common shell for Linux users. The 'Next steps' section links to both CLI and PowerShell guides, but PowerShell is given equal prominence, which may reinforce Windows-centric patterns.
Recommendations
- Prioritize Bash/Azure CLI instructions and visuals before PowerShell, reflecting the default Linux shell experience in Cloud Shell.
- Explicitly state that Bash/Azure CLI is cross-platform and the default for Cloud Shell, while PowerShell is optional.
- Add notes or sections highlighting Linux-specific workflows or considerations, such as file paths, permissions, or scripting differences.
- Ensure that all examples and screenshots default to Bash unless PowerShell is specifically required.
- Review and adjust the order of 'Next steps' links to feature CLI/Bash resources first, followed by PowerShell as an alternative.
Create Pull Request