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
Summary:
The documentation demonstrates a moderate Windows bias. PowerShell examples are presented before Azure CLI examples, and the PowerShell section is more detailed (including retrieval and removal commands). The documentation refers to 'scripts' and 'commands' in a way that assumes familiarity with PowerShell, and the Azure portal UI instructions use terminology and screenshots that are more familiar to Windows users. There are no explicit Linux-specific instructions or examples, and the CLI examples are not highlighted as the primary or preferred method.
Recommendations:
- Present Azure CLI examples before or alongside PowerShell examples to avoid implying PowerShell is the default or preferred method.
- Ensure parity in the depth and breadth of examples for both PowerShell and Azure CLI, including retrieval and removal operations.
- Add explicit notes that both Azure CLI and PowerShell are cross-platform, and clarify that CLI commands work natively on Linux/macOS.
- Where possible, include Linux/macOS-specific tips or troubleshooting notes (e.g., shell syntax differences, environment variable usage).
- Consider providing Bash script equivalents for multi-step operations, and clarify that the Azure portal is accessible from any OS.
- Avoid using Windows-centric terminology or UI references unless necessary, or provide equivalent guidance for non-Windows users.
Create pull request