Bias Analysis
Detected Bias Types
windows_tools
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation generally provides parity between Windows and Linux instructions, but there are subtle signs of Windows bias. Windows-specific tools (e.g., Kudu console) are mentioned for file operations, while Linux relies on SSH. In some cases, Windows-specific settings (such as 'XDT_MicrosoftApplicationInsights_Java=1') are included, and Windows instructions sometimes appear before or are more detailed than Linux equivalents. There is also a tendency to reference Windows-centric patterns (like Kudu) without offering Linux alternatives (e.g., SCP, SFTP, or Azure CLI for file uploads).
Recommendations
- For file operations, mention Linux-native tools (SCP, SFTP, Azure CLI) alongside SSH, not just SSH for Linux and Kudu for Windows.
- Ensure that Linux instructions are as detailed as Windows ones, especially regarding environment variables and agent configuration.
- When introducing platform-specific settings (like 'XDT_MicrosoftApplicationInsights_Java=1'), explain their Linux equivalents or clarify if not needed.
- Avoid Windows-first ordering in examples and instructions; present Linux and Windows in parallel or alternate which comes first.
- Where possible, provide cross-platform CLI instructions and avoid referencing Windows-only tools unless absolutely necessary.
Create Pull Request