Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation exhibits a Windows bias by frequently referencing Windows PowerShell as the default local shell for Azure CLI usage, providing file path examples in Windows format (e.g., C:\demo-file.txt), and prioritizing PowerShell examples. There is little to no mention of Linux shells (bash, zsh) or Linux file path conventions, and Windows tools (PowerShell) are referenced before their Linux equivalents. This may make the documentation less approachable for Linux/macOS users.
Recommendations
- When referencing local shell usage for Azure CLI, mention both Windows PowerShell and common Linux/macOS shells (e.g., bash, zsh).
- Provide file path examples in both Windows (C:\demo-file.txt) and Linux/macOS (/home/user/demo-file.txt) formats.
- Avoid using Windows-only terminology (e.g., 'open a command console application such as Windows PowerShell') and instead use neutral language like 'open a terminal or command prompt'.
- Ensure that CLI and AzCopy examples are explicitly shown to work on Linux/macOS, and note any platform-specific differences.
- Consider including screenshots or instructions for Linux/macOS environments where relevant.
Create Pull Request