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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation provides both Azure CLI and Azure PowerShell instructions for checking and updating tool versions, but PowerShell (a Windows-centric tool) is given equal prominence to the cross-platform Azure CLI. PowerShell-specific commands and update instructions are detailed, and links to PowerShell documentation are included. There is no mention of Linux-specific shell commands or package managers (e.g., apt, yum, Homebrew) for updating the Azure CLI or PowerShell, nor are there examples for Linux/macOS environments. The documentation implicitly assumes familiarity with Windows/PowerShell tooling.
Recommendations:
- Provide explicit Linux/macOS instructions for updating Azure CLI and Azure PowerShell, including common package manager commands (e.g., apt-get, yum, brew).
- Clarify that Azure CLI is cross-platform and provide shell command examples for bash/zsh users.
- When listing tools, mention cross-platform options (like Azure CLI) before Windows-centric ones (like PowerShell), or group them by platform.
- Include example commands for both Windows (PowerShell) and Linux/macOS (bash) where relevant.
- Link to platform-specific installation/update guides for both CLI and PowerShell.
Create pull request