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
⚠️
windows_tools
Summary:
The documentation provides detailed instructions for the Azure Portal, Azure CLI, and PowerShell. While the Azure CLI is cross-platform, the explicit inclusion of PowerShell (which is traditionally associated with Windows environments) and the use of PowerShell-specific cmdlets indicate a bias towards Windows users. Additionally, the PowerShell section is given equal prominence to the CLI, and there are no explicit Linux shell (bash) examples or references to Linux-native tools or workflows. The CLI examples use the Azure CLI, which is available on Linux, but there is no mention of running these commands in a Linux environment or using bash scripting, and the CLI section is labeled with 'azurepowershell-interactive', which may be confusing.
Recommendations:
- Add explicit bash shell examples for the Azure CLI section, showing usage in a Linux/macOS terminal.
- Clarify that the Azure CLI commands can be run on Linux, macOS, and Windows, and provide example shell prompts (e.g., $ for bash).
- If PowerShell is included, also include bash equivalents for parity.
- Avoid labeling CLI code blocks as 'azurepowershell-interactive' when they are standard Azure CLI commands.
- Mention that PowerShell Core is cross-platform if you intend to support Linux, or clarify that the PowerShell examples are for Windows users.
- Consider the order of sections: present the Azure CLI (cross-platform) before PowerShell to avoid a 'windows_first' impression.
Create pull request