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 provides examples for both Azure CLI and Azure PowerShell, but PowerShell examples are given equal prominence to CLI, and in some sections, PowerShell is mentioned before or alongside CLI. PowerShell is a Windows-centric tool, and its inclusion without explicit mention of Linux alternatives or parity may suggest a bias towards Windows users. There are no explicit Linux-specific instructions, nor are there examples using Bash or other common Linux shells. The documentation also references Azure portal (web-based) and REST API, which are cross-platform, but the command-line focus is split between CLI (cross-platform) and PowerShell (primarily Windows).
Recommendations:
- Clearly indicate that Azure CLI commands work natively on Linux, macOS, and Windows, while PowerShell is primarily for Windows (though available on Linux).
- Add explicit Bash shell examples for Linux users where scripting is involved, especially for variable assignment and command chaining.
- In tabbed examples, list Azure CLI before PowerShell to reflect its cross-platform nature and reduce perceived Windows-first bias.
- Where PowerShell is referenced, note that PowerShell Core is available on Linux, and provide installation links or guidance.
- Consider including a section or note on using these tools in Linux environments, including any prerequisites or differences.
- If possible, provide sample scripts or automation guidance using Bash for Linux users, especially in sections involving role assignments or identity management.
Create pull request