Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates a Windows bias by exclusively using Visual Studio (a Windows-centric IDE) for all development steps, recommending Windows tools like Data Lake Tools for Visual Studio and Azure PowerShell, and providing step-by-step instructions for building, uploading, and running jobs via Visual Studio. Linux alternatives for development, file upload, and job submission are not described, even though the cluster itself is Linux-based. Only the Pig job section briefly mentions SSH, but no Linux-native development or upload workflow is covered.
Recommendations
- Add instructions for building C# projects using cross-platform tools such as 'dotnet build' or MonoDevelop on Linux/macOS.
- Provide examples for uploading .exe files using Azure CLI, azcopy, or SCP from Linux/macOS terminals.
- Include steps for submitting Hive queries via SSH and command-line tools (e.g., Beeline, Hive CLI) on Linux, rather than only through Visual Studio.
- Mention and demonstrate using VS Code or other cross-platform editors for development.
- Reorder recommendations so that cross-platform and Linux-native tools are presented before or alongside Windows tools.
- Clarify that Visual Studio is optional and highlight equivalent Linux workflows for all major steps.
Create Pull Request