Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a significant Windows bias. All development examples use Visual Studio (a Windows-centric IDE) and reference Windows workflows (e.g., Server Explorer, Data Lake Tools for Visual Studio) for building, uploading, and running C# UDFs. Azure PowerShell is mentioned as a recommended tool, but Linux equivalents (such as SSH, SCP, or Linux-native editors) are not described or are relegated to later sections. The process for running Pig jobs does use SSH, but there are no Linux-native development or upload instructions, and all code creation steps assume Visual Studio on Windows.
Recommendations
- Provide step-by-step instructions for building C# projects on Linux using Mono and command-line tools (e.g., dotnet CLI, msbuild, or MonoDevelop).
- Include examples of uploading .exe files to HDInsight storage using Linux tools (e.g., Azure CLI, azcopy, scp) rather than only Visual Studio workflows.
- Mention and demonstrate Linux-native editors (e.g., VS Code, Vim, Emacs) for code creation and editing.
- Present Azure CLI usage before or alongside Azure PowerShell, as CLI is cross-platform.
- Add explicit instructions for running Hive queries from the command line (e.g., using beeline or hive CLI) on Linux, not just through Visual Studio.
- Clarify which steps are platform-agnostic and which are specific to Windows, and ensure Linux users have clear, parallel guidance.
Create Pull Request