Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates several forms of Windows bias. Windows terminology and tools (e.g., %USERPROFILE%, PowerShell syntax, Select-String) are used or referenced before or instead of Linux equivalents. In the log review section, the Linux example incorrectly uses PowerShell's Select-String rather than a native Linux tool like grep. Windows-specific quoting conventions are explained in detail, while Linux conventions are mentioned only in passing. The default paths reference Windows first, and the environment variable setting examples use PowerShell before bash. There is a lack of true Linux-native command examples, especially for log searching.
Recommendations
- Replace the Linux example for log searching with a native command, such as: grep UPLOADFAILED ./04dc9ca9-158f-7945-5933-564021086c79.log
- When mentioning default paths, list Linux/Mac first or equally (e.g., $HOME/.azcopy on Linux/Mac, %USERPROFILE%\.azcopy on Windows).
- Provide bash/zsh examples before or alongside PowerShell examples for environment variable manipulation.
- Expand explanations of quoting conventions to include more detail for Linux shells (e.g., differences between single and double quotes in bash).
- Review the documentation for other places where Windows tools or terminology are used exclusively and add Linux equivalents.
- Consider adding a table or section summarizing cross-platform differences for common AzCopy operations.
Create Pull Request