Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation page presents Windows-specific environment variable setup commands (setx, PowerShell) before Linux/macOS equivalents, and uses Windows terminology (command prompt, restart the command prompt) without mentioning Linux shells. The Linux/macOS export command is shown after Windows examples, and lacks details about shell persistence. There are no Linux-specific screenshots or portal instructions, and the cleanup section is not platform-specific. Most CLI examples use Azure CLI, which is cross-platform, but the environment variable setup is Windows-centric.
Recommendations
- Present Linux/macOS environment variable setup commands before or alongside Windows commands, with equal detail.
- Clarify shell-specific instructions for Linux/macOS (e.g., mention .bashrc/.zshrc for persistence, restarting the shell).
- Use neutral terminology like 'terminal' instead of 'command prompt', and clarify instructions for different platforms.
- Add Linux/macOS screenshots or notes where portal UI may differ.
- Ensure all steps are equally clear for Linux/macOS users, especially around authentication and environment setup.