Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation presents both Bash (Linux) and PowerShell (Windows) options for Azure Cloud Shell, but PowerShell is consistently given equal prominence to Bash, and in some cases, PowerShell-specific features (such as the Azure drive and cmdlets) are described in more detail. The 'Next steps' section lists Azure PowerShell before Azure CLI, subtly prioritizing Windows tooling. There are no Linux-specific examples or references to Linux tools beyond Bash, and PowerShell features (like the Azure drive) are highlighted without Linux equivalents.
Recommendations
- Ensure that Bash/Linux examples are as detailed as PowerShell ones, especially where PowerShell-specific features (like the Azure drive) are described.
- Alternate the order of CLI and PowerShell examples to avoid implicit prioritization.
- Include references to Linux-specific tools or workflows where relevant, such as file manipulation or scripting within Bash.
- In 'Next steps', list Azure CLI and Azure PowerShell in alphabetical order or alternate their order in different documentation pages.
- Add a note clarifying that Bash is the default shell for many Linux users, and highlight any Bash-specific features or tips.
Create Pull Request