Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a bias towards Windows environments. It exclusively provides examples for .NET (C#) applications, which are most commonly developed and run on Windows. Package installation instructions use NuGet and the Install-Package command, which is typically executed in Windows PowerShell. There are no examples or guidance for Linux users, such as using .NET Core cross-platform tools, running the application on Linux, or alternative package managers. The prerequisites and instructions assume use of the Azure portal and PowerShell, with no mention of CLI or Linux-specific workflows.
Recommendations
- Add examples for developing and running .NET applications on Linux, including using the .NET CLI (dotnet) for project creation and package management.
- Provide instructions for installing required packages using the dotnet CLI (e.g., 'dotnet add package') instead of only NuGet/Install-Package.
- Include guidance for authenticating and managing Azure resources using the Azure CLI, which is cross-platform, alongside PowerShell examples.
- Clarify that .NET Core and .NET 5+ applications can run on Linux and macOS, and provide sample commands for these platforms.
- Mention any platform-specific considerations for running HDInsight client applications on Linux, such as dependencies or environment setup.
- Ensure that all code and instructions are validated to work on both Windows and Linux environments.
Create Pull Request