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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias by presenting Azure PowerShell instructions and terminology before Azure CLI equivalents throughout the feature registration and unregistration sections. There is a heavy reliance on PowerShell examples, and no explicit Linux or Bash shell examples are provided. The CLI examples are present but are not contextualized for Linux users (e.g., no Bash scripting, no mention of shell environments). The documentation assumes familiarity with Windows-centric tools and patterns, and does not address Linux-specific workflows or considerations.
Recommendations:
- Alternate the order of PowerShell and CLI instructions, or present CLI (cross-platform) first to avoid Windows-first bias.
- Explicitly mention that Azure CLI commands can be run on Linux, macOS, and Windows, and provide example shell environments where appropriate.
- Include Bash shell script examples for common tasks, especially for steps that are likely to be automated in Linux environments.
- Where screenshots or UI steps are provided, consider including CLI or script-based alternatives for users who prefer or require non-GUI workflows.
- Add a section or callout for Linux users, highlighting any differences or tips for using the Azure CLI or other tools on Linux.
- Ensure that references to tools (e.g., PowerShell, CLI) clarify their cross-platform availability and usage.
Create pull request