Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page for Azure Cloud Shell features demonstrates a moderate Windows bias. PowerShell is frequently highlighted, with features like the Azure drive ('Azure:') described only for PowerShell and not for Bash. Many Microsoft service integrations are listed as PowerShell modules, and examples for listing installed modules are given for PowerShell before Bash. Several tools are Windows-centric (e.g., Exchange Online PowerShell, Office 365 CLI, Microsoft Graph PowerShell, SqlServer PowerShell modules), and there is a lack of equivalent Linux/Bash examples or parity in feature descriptions. The documentation often mentions PowerShell and Windows tools first or exclusively, while Linux/Bash alternatives are less emphasized or missing.
Recommendations
- Provide equivalent Bash examples for features currently described only for PowerShell, such as Azure resource navigation.
- List Bash/Linux commands alongside PowerShell commands when describing how to view installed modules and packages.
- Highlight open source and Linux-native tools with equal prominence as Microsoft/Windows-centric tools.
- Add examples and documentation for managing Azure resources using Bash and Azure CLI, not just PowerShell.
- Ensure that feature descriptions do not prioritize Windows/PowerShell tools and modules over Linux/Bash alternatives.
- Include links to Linux/Bash documentation where relevant, similar to the links provided for PowerShell modules.
Create Pull Request