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
⚠️
missing_linux_example
Summary:
The documentation exhibits a mild Windows bias. Portal-based instructions and terminology are platform-neutral, but the only explicit OS-specific references and examples are for Windows. The Docker example mentions running in an 'elevated command prompt' and refers to 'Docker on Windows' with a link, but does not mention Linux or macOS equivalents. In the CLI extension installation section, both Bash (Azure CLI) and PowerShell examples are given, but the PowerShell section is more detailed (including update instructions), and there is no mention of Linux-specific shell environments or troubleshooting. There are no explicit Linux/macOS instructions or links, and no screenshots or notes for non-Windows users.
Recommendations:
- For Docker instructions, explicitly mention that the 'docker run' command works on Linux and macOS as well, and provide links to Docker installation guides for those platforms.
- When referencing an 'elevated command prompt', add a note for Linux/macOS users to use 'sudo' if necessary.
- In the CLI extension section, provide parity between Bash and PowerShell instructions (e.g., show how to update the Azure CLI extension in Bash, not just PowerShell module updates).
- Wherever a Windows-specific tool or pattern is mentioned (such as 'command prompt'), add the Linux/macOS equivalent (such as 'terminal').
- Consider including a short section or callout for Linux/macOS users, especially in sections where OS-specific behavior or troubleshooting may differ.
- Add links to Linux/macOS troubleshooting or installation documentation where appropriate.
Create pull request