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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation shows a Windows bias by presenting Windows-specific information and tools first, such as mentioning Windows SKU availability before Linux, and including Azure PowerShell examples (which are primarily used on Windows) without equivalent Bash or Linux shell script examples. The automation section provides both Azure CLI and PowerShell, but the PowerShell example is not accompanied by a Linux-native scripting example. The portal instructions and screenshots are Windows-centric, and there is no mention of Linux-specific considerations or UI differences. Additionally, the documentation does not provide parity in examples or guidance for Linux users, especially for scripting and automation.
Recommendations:
- Present Linux and Windows options in parallel, or alternate which comes first to avoid 'windows_first' bias.
- Provide Bash or shell script examples alongside PowerShell for automation tasks.
- Include screenshots or notes for both Windows and Linux portal experiences if they differ.
- Explicitly mention any Linux-specific considerations, such as differences in deployment, configuration, or tool usage.
- Ensure that all command-line examples (especially for automation) are cross-platform or have equivalents for both Windows and Linux users.
Create pull request