Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by consistently providing Azure PowerShell examples and references before (or instead of) Azure CLI equivalents. In several places, only PowerShell commands are shown for key tasks, with Azure CLI mentioned as an alternative but not exemplified. There are no explicit Linux/bash shell examples, and the use of PowerShell is assumed as the default scripting environment. This may disadvantage Linux users or those who prefer cross-platform CLI tools.
Recommendations
- Provide Azure CLI (az) command examples alongside PowerShell for all tasks, especially for counting role assignments and querying user information.
- Explicitly mention that Azure CLI works on Linux, macOS, and Windows, and link to installation guides for non-Windows platforms.
- Where scripting is shown, offer both PowerShell and bash (or shell-agnostic) syntax, or use tabs to let users select their preferred environment.
- Review references to tools and commands to ensure Linux parity, e.g., avoid assuming PowerShell is the default and highlight cross-platform alternatives.
- Add a section or note clarifying that all operations can be performed from Linux/macOS using Azure CLI and REST API, not just PowerShell.
Create Pull Request