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
Summary:
The documentation provides both PowerShell and Azure CLI commands for listing VM sizes and images, but PowerShell (a Windows-centric tool) is consistently mentioned first in all lists and examples. There are no Linux-specific shell examples (e.g., Bash), and the documentation does not mention or demonstrate Linux-native tools or patterns, despite Azure CLI being cross-platform. This ordering and tool selection subtly prioritize Windows users and workflows.
Recommendations:
- Alternate the order of PowerShell and Azure CLI in lists and examples, or list Azure CLI first to reflect its cross-platform nature.
- Explicitly mention that Azure CLI commands can be run on Linux, macOS, and Windows, and provide Bash shell examples where appropriate.
- Where possible, include Linux-native command-line patterns (e.g., Bash scripting) alongside PowerShell examples.
- Add a note clarifying that PowerShell Core is available cross-platform, but that Azure CLI is the recommended tool for Linux users.
- Review other documentation pages for similar ordering and tool selection to ensure consistent cross-platform parity.
Create pull request