About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
windows_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by frequently referencing PowerShell, using Windows-centric tools and terminology (e.g., AzPowershell, PowerShell@2 tasks), and omitting explicit Linux shell or cross-platform CLI examples. Even when CI runners are set to Ubuntu, the scripts and instructions default to PowerShell syntax and tools, with no Bash or Linux-native alternatives provided. This may hinder Linux-first or cross-platform users.
Recommendations:
- Provide equivalent Bash or sh examples alongside PowerShell commands, especially for npm, dotnet, and Playwright CLI usage.
- When showing CI pipeline YAML, offer both PowerShell and Bash script variants, or use cross-platform steps where possible.
- Avoid using Windows-specific terminology (e.g., 'AzPowershell', 'PowerShell@2') as the default; clarify when steps are cross-platform or provide Linux/macOS alternatives.
- Explicitly mention that all steps work on Linux/macOS, and highlight any platform-specific considerations.
- For command-line snippets, default to Bash or provide both Bash and PowerShell versions, especially for Playwright and npm commands.
- Review all code blocks and workflow steps to ensure Linux users are not required to mentally translate from PowerShell to Bash.
Create pull request