About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
windows_first
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows-first bias by focusing on migration from Windows-based HDInsight and providing instructions that rely heavily on Windows-specific tools (Visual Studio, .NET Portability Analyzer for Visual Studio). There are no examples or guidance for performing equivalent steps (such as portability analysis, building, or deploying) using Linux-native tools or workflows. The documentation assumes the user is developing on Windows and does not address Linux development environments.
Recommendations:
- Provide instructions for running the .NET Portability Analyzer or similar tools on Linux (e.g., via command-line or cross-platform alternatives).
- Include examples of building .NET projects for Mono/HDInsight using cross-platform tools such as the dotnet CLI or Mono's xbuild/msbuild on Linux.
- Offer guidance for users developing on Linux, not just those migrating from Windows.
- Mention Linux file path conventions and provide code examples that are platform-agnostic or demonstrate both Windows and Linux paths.
- Reference Linux-native editors or IDEs (such as VS Code, JetBrains Rider, or MonoDevelop) as alternatives to Visual Studio.
Create pull request