Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page exhibits several signs of Windows bias. Windows terminology and tools (e.g., %USERPROFILE%, PowerShell syntax) are mentioned first or exclusively in several places. The log location is described with Windows syntax before Linux/Mac, and the main example for searching logs uses PowerShell's Select-String in both the Linux and Windows tabs, which is not standard for Linux shells. There are missing Linux-native examples (e.g., grep for log searching), and Windows-specific quoting conventions are explained in detail, while Linux conventions are mentioned only as an exception.
Recommendations
- Provide Linux-native command examples (e.g., use 'grep' instead of 'Select-String' for log searching in Linux).
- List Linux/Mac paths and conventions before or alongside Windows equivalents, rather than after.
- Use environment variable syntax that matches the platform (e.g., $HOME/.azcopy for Linux/Mac, %USERPROFILE%\.azcopy for Windows), and clarify the difference.
- Explain quoting conventions for both platforms equally, and consider a table for clarity.
- Avoid using PowerShell commands in Linux examples; use bash or sh syntax where appropriate.
- Ensure that any platform-specific instructions are balanced and clearly marked.
Create Pull Request