Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in the installation instructions for the Azure Developer CLI. The only command-line installation example provided uses PowerShell, with no mention of Linux/macOS installation methods or shell commands. This omission may hinder Linux/macOS users, as they are not given clear guidance for their platforms. Additionally, the PowerShell example is presented before any mention of cross-platform support, reinforcing a Windows-first perspective.
Recommendations
- Provide explicit installation instructions for Linux and macOS, including bash/zsh commands (e.g., using curl or package managers like apt, yum, or Homebrew).
- Add tabs or sections for each supported platform (Windows, Linux, macOS) in the installation instructions, ensuring parity.
- Avoid presenting only PowerShell scripts; always include equivalent bash commands where possible.
- Clearly state cross-platform support at the beginning of installation/setup sections.
- Where screenshots or UI steps are shown, clarify if they are platform-specific or provide alternatives for other platforms.
Create Pull Request