Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a clear Windows bias. Windows PowerShell is referenced as the primary shell for running Azure CLI commands, and all CLI and PowerShell command examples are shown with Windows-style prompts (e.g., 'PS C:\Windows>'). There is no mention or example of running commands from a Linux or macOS terminal, nor are there any bash/zsh-specific instructions or screenshots. Installation instructions and prerequisites focus on Windows tools (e.g., MSI installer, Windows PowerShell), and there are no Linux-specific installation or usage notes. The documentation assumes a Windows environment throughout, omitting Linux/macOS parity.
Recommendations
- Provide explicit Linux/macOS installation instructions for Azure CLI and PowerShell, including package manager commands (e.g., apt, yum, brew).
- Include CLI examples using bash/zsh shell prompts (e.g., '$ az login'), and clarify that Azure CLI commands work cross-platform.
- Show sample outputs from Linux/macOS terminals as well as Windows.
- Avoid language such as 'Open up a Windows PowerShell command window' when describing generic CLI usage; instead, use neutral terms like 'Open a terminal'.
- Mention that Azure CLI and PowerShell Core are available on Linux and macOS, and link to relevant installation guides.
- If possible, add a 'Linux/macOS' tab or section parallel to 'PowerShell' and 'Azure CLI' to demonstrate parity and inclusivity.
Create Pull Request