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_first
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias by prioritizing PowerShell examples, referencing PowerShell before CLI or cross-platform tools, and omitting explicit Linux shell (bash) or macOS-specific instructions. The CLI example is present but follows the PowerShell example, and there are no explicit Linux/macOS setup or troubleshooting notes. The use of PowerShell as the primary programmatic example and the lack of Linux-specific context or parity in screenshots and instructions further reinforce the bias.
Recommendations:
- Present CLI (az) examples before or alongside PowerShell examples, emphasizing its cross-platform nature.
- Include explicit bash/Linux shell examples and troubleshooting notes for Linux/macOS users (e.g., environment variable setup, file path differences).
- Add a section or callout noting that Azure CLI and Terraform are fully supported on Linux and macOS, and provide links to relevant installation guides.
- Ensure screenshots and navigation instructions are OS-agnostic or include Linux/macOS UI where relevant.
- Review language to avoid implying PowerShell is the default or preferred automation tool; clarify that both CLI and PowerShell are supported.
- Where PowerShell is mentioned, add equivalent bash/CLI commands for common tasks (e.g., authentication, selecting subscriptions).
Create pull request