Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents both Bash (Azure CLI) and PowerShell examples for deploying ARM templates in Azure Cloud Shell. However, PowerShell is given equal prominence to Bash throughout, and in some places (such as the 'Next steps' section), PowerShell is mentioned before Bash/CLI. The documentation refers to 'PowerShell' without clarifying that it is cross-platform, which may reinforce a Windows-centric perspective. There are no Linux-specific tools or patterns mentioned, and the examples do not highlight any Linux-specific considerations.
Recommendations
- Explicitly clarify that PowerShell in Cloud Shell is cross-platform and not Windows-specific.
- Ensure Azure CLI (Bash) examples are presented before PowerShell examples to avoid implicit Windows-first bias.
- Include references to Linux-specific tools or workflows where relevant, such as using native Linux editors or scripting approaches.
- In the 'Next steps' section, list Azure CLI documentation before PowerShell to reinforce platform neutrality.
- Add a note explaining that both Bash and PowerShell are available in Cloud Shell regardless of the user's OS, and that the instructions apply equally to Linux and Windows users.
Create Pull Request