Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a strong Windows bias. Windows PowerShell is consistently referenced as the default or primary environment for running Azure CLI and PowerShell commands. All CLI and PowerShell command examples use Windows-style prompts (e.g., PS C:\Windows>), and instructions for installing tools (Azure CLI, PowerShell) focus on Windows-specific installers (MSI) and Windows PowerShell versions. There are no explicit examples or guidance for Linux or macOS users, such as using Bash, zsh, or Linux-native package managers. The use of Windows terminology and screenshots further reinforces this bias, while Linux equivalents are missing or only briefly mentioned as options (e.g., Azure Cloud Shell supports Bash, but all examples default to Windows PowerShell).
Recommendations
- Provide explicit Linux and macOS instructions for installing Azure CLI and PowerShell, including package manager commands (apt, yum, brew, etc.).
- Include CLI and PowerShell command examples using Bash/zsh shell prompts (e.g., $ az login) alongside Windows PowerShell examples.
- Add screenshots and walkthroughs for Linux terminal environments and macOS, not just Windows.
- Mention and demonstrate how to use Azure CLI and PowerShell in Bash or other shells, including differences in environment setup and command syntax.
- Ensure that all sample outputs and command prompts are shown in both Windows and Linux/macOS formats.
- Avoid language that assumes Windows as the default platform (e.g., 'Open up a Windows PowerShell command window') and instead use neutral phrasing or provide parallel instructions for other platforms.
Create Pull Request