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_tools
⚠️
missing_linux_example
⚠️
windows_first
Summary:
The documentation demonstrates a Windows bias by providing only PowerShell-based instructions for interacting with Azure resources (e.g., opening PowerShell, using ARMClient in a PowerShell window), and does not mention or provide equivalent steps for Linux or macOS users. The ARMClient tool is introduced with a Windows-centric installation process (downloading and unzipping a .zip, running in PowerShell), and there are no Bash or cross-platform CLI alternatives shown. This may hinder users on non-Windows platforms from following the troubleshooting steps effectively.
Recommendations:
- Provide equivalent Linux/macOS instructions, such as using Bash or Azure CLI commands for authentication and resource queries.
- Mention and demonstrate how to install and use ARMClient (or an equivalent tool) on Linux/macOS, or suggest cross-platform alternatives (e.g., Azure CLI az rest).
- When listing steps, avoid assuming the user is on Windows; present cross-platform options or indicate which steps are OS-specific.
- If PowerShell is required, clarify if PowerShell Core (pwsh) can be used on Linux/macOS, and provide relevant instructions.
- Consider reordering or parallelizing instructions so that Linux/macOS methods are presented alongside Windows methods, rather than after or not at all.
Create pull request