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:
Summary:
The documentation exclusively uses the Azure Portal (web UI) and Azure Resource Graph (via the portal) for all examples and instructions. There are no command-line examples provided for any platform (Windows, Linux, or macOS), but notably, there is a lack of Azure CLI, Bash, or PowerShell command examples. This omission is a form of bias because it does not address users who prefer or require command-line tools, especially on Linux or macOS platforms. The documentation implicitly assumes a GUI workflow, which is more common among Windows users, and does not mention or provide parity for Linux-oriented workflows.
Recommendations:
- Add Azure CLI examples for all major operations described (listing classic administrators, removing/converting roles, etc.), as Azure CLI is cross-platform and widely used on Linux.
- Where possible, provide both Azure CLI and PowerShell examples, and ensure Azure CLI (or Bash) examples are presented first or alongside PowerShell to avoid Windows-first bias.
- Explicitly mention that all operations can be performed via command-line tools on any supported OS, and link to relevant Azure CLI documentation.
- If certain operations are only available in the portal, clearly state this and provide a roadmap or alternatives for command-line users.
Create pull request