Document Details
Api Version Retirement Sep 2023
❌
This page contains Windows bias
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 gives both Azure CLI and Azure PowerShell instructions for checking and updating tool versions, but the PowerShell example is presented alongside the CLI without explicit Linux/bash alternatives. PowerShell is a Windows-centric tool, and its mention without equivalent bash or shell commands may disadvantage Linux users. Additionally, the documentation references the Azure portal (a web UI) and REST API, but does not provide explicit Linux shell or bash script examples, nor does it clarify cross-platform usage for the CLI commands. The focus on PowerShell and lack of explicit Linux-native instructions indicate a mild Windows bias.
Recommendations:
- For every PowerShell example, provide an equivalent bash or shell command for Linux/macOS users.
- Clarify that Azure CLI commands are cross-platform and can be run in bash, zsh, or other shells, not just Windows Command Prompt or PowerShell.
- Explicitly mention that Azure CLI is available on Linux, macOS, and Windows, and provide installation/update links for all platforms.
- Where possible, provide sample scripts or commands in both PowerShell and bash to ensure parity.
- Add a note or section addressing Linux/macOS users, highlighting any differences or considerations.
Create pull request