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 exhibits a Windows bias primarily through the use of PowerShell commands and references to Windows-centric tools (such as AzPowerShell and Azure PowerShell) in both setup and workflow examples. The authentication and setup instructions often mention PowerShell or Windows tools first or exclusively, with no explicit Linux or cross-platform shell alternatives provided. While the CI runners are set to 'ubuntu-latest', the scripts and instructions assume familiarity with PowerShell, and there are no bash or Linux-native command examples. This may hinder Linux users or those working in non-Windows environments.
Recommendations:
- Provide equivalent bash or sh examples for all PowerShell commands, especially for steps like installing dependencies, authentication, and running Playwright tests.
- When referencing Azure CLI or authentication, include both Azure PowerShell and Azure CLI instructions, and clarify which is cross-platform.
- Avoid using PowerShell-specific syntax in generic instructions; prefer platform-agnostic commands where possible.
- Explicitly mention that all steps are cross-platform, or provide separate tabs/examples for Windows (PowerShell), Linux (bash), and macOS where relevant.
- For CI workflow YAML, show both PowerShell and bash script blocks, or use shell: bash for Linux runners.
- Ensure that all tool references (such as 'AzPowerShell') are accompanied by their Linux/macOS equivalents or alternatives.
Create pull request