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 in several ways: PowerShell and Windows-specific tools (e.g., AzPowershell, Azure PowerShell, PowerShell@2 tasks) are used or referenced in CI examples and authentication setup, often without equivalent Bash or Linux shell examples. The use of PowerShell is shown in both GitHub Actions and Azure Pipelines, and Windows tools are mentioned before or instead of cross-platform/Linux alternatives. There are no explicit Linux shell (bash/sh) command examples for common developer workflows, and the documentation does not provide parity for Linux-first or cross-platform users.
Recommendations:
- For every PowerShell or Windows-specific command or task, provide an equivalent Bash (sh) example, especially for CI/CD steps.
- In authentication setup, include Azure CLI (az) commands alongside Azure PowerShell, and clarify which commands are cross-platform.
- When referencing tools or scripts (e.g., 'PowerShell@2', 'AzPowershell'), also show how to accomplish the same with Bash or cross-platform alternatives.
- Avoid using Windows-specific terminology or tools as the default; instead, present cross-platform or Linux-first options first, or at least side-by-side.
- Explicitly mention that all workflows and commands are supported on Linux runners (e.g., Ubuntu) and provide sample shell commands for local Linux development.
- Add a section or callout for Linux/macOS users, highlighting any differences or confirming full support.
Create pull request