Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits several signs of Windows bias. Windows tools and terminology (e.g., PowerShell, Windows PowerShell, C:\ paths) are mentioned first or exclusively in command examples and instructions. PowerShell is given a dedicated section, and instructions often reference Windows-specific consoles and file paths. There is a lack of explicit Linux or macOS examples, especially for local CLI usage, and no mention of Linux-specific shell environments or file path formats. The documentation assumes familiarity with Windows tools and patterns, which may hinder Linux users.
Recommendations
- Include explicit instructions and examples for Linux/macOS users, such as using Bash or Terminal instead of Windows PowerShell.
- Provide file path examples using Linux/macOS formats (e.g., /home/user/index.html) alongside Windows paths.
- Clarify that Azure CLI commands can be run from any OS and show how to open a terminal on Linux/macOS.
- Add notes or sections for installing and using Azure CLI and AzCopy on Linux/macOS.
- Balance the order of examples so that Linux/macOS instructions are presented alongside or before Windows-specific ones.
- Avoid assuming the use of Windows tools (e.g., PowerShell) as the default for all users.
Create Pull Request