Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a Windows-first bias in several areas. Windows examples and tools (such as PowerShell) are presented before Linux equivalents, and some commands (e.g., extension status, update, removal) only show the Windows extension name, omitting the Linux variant. PowerShell instructions are included for both OSes, but PowerShell is a native Windows tool and less common on Linux. Troubleshooting and log paths are covered for both OSes, but overall, Windows terminology and examples are more prominent.
Recommendations
- Present Linux examples and extension names alongside Windows in all CLI and PowerShell command sections (e.g., show, update, delete).
- Where PowerShell is used, clarify its availability on Linux or provide Bash/Shell alternatives for Linux users.
- Ensure all instructions, troubleshooting steps, and log paths are equally detailed for Linux as for Windows.
- Avoid using Windows-centric terminology (e.g., 'migration.windowsazure.com') without noting Linux applicability.
- Consider alternating the order of Windows and Linux examples to avoid implicit prioritization.
Create Pull Request