Detected Bias Types
Windows First
Missing Linux Example
Summary
The documentation consistently presents Azure Portal (a web GUI, typically accessed from Windows environments) instructions before Azure CLI examples. There are no examples or references to Linux-specific tools, shell environments, or command-line patterns (e.g., Bash, SSH, SCP, etc.). All CLI examples use Azure CLI, which is cross-platform, but the documentation does not mention or show usage from Linux terminals, nor does it provide parity for Linux-specific workflows (such as connecting via SSH, using Bash scripting, or referencing Linux authentication patterns). There is a subtle Windows-first bias in ordering and in the lack of explicit Linux context.
Recommendations
- Add explicit examples of using Azure CLI from Linux terminals (e.g., Bash), including screenshots or terminal output from Linux environments.
- Mention that Azure CLI is cross-platform and provide instructions for installing and using it on Linux.
- Include references to Linux-native tools and workflows where relevant (e.g., SSH for connecting to BareMetal instances, Bash scripting for automation).
- Balance the ordering of examples so that CLI instructions are presented before or alongside portal instructions, emphasizing parity.
- Where screenshots are shown, include examples from Linux desktops or terminals, not just the Azure Portal web interface.