Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias, especially in the section describing how to use the Az CLI. It instructs users to open PowerShell as Administrator and execute CLI commands, without mentioning Linux/macOS terminals or providing equivalent instructions. The CLI examples are presented in a Windows-centric context, and there is no guidance for Linux/macOS users regarding terminal usage, privilege elevation, or command syntax differences. The rest of the documentation is largely portal-based and platform-agnostic, but the CLI section creates friction for non-Windows users.
Recommendations
- Explicitly mention that Az CLI can be used on Linux, macOS, and Windows, and provide instructions for opening a terminal on each platform.
- Replace 'open PowerShell on your system as an Administrator' with platform-neutral language such as 'open your terminal (PowerShell on Windows, Terminal on Linux/macOS)'.
- Clarify privilege elevation steps for Linux/macOS (e.g., using 'sudo' if required) alongside Windows instructions.
- Provide example CLI commands in a platform-agnostic format, and note any differences in command syntax or environment.
- Add links to Az CLI installation instructions for Linux and macOS, not just Windows.
Create Pull Request