Azure Relay

44
Total Pages
23
Linux-Friendly Pages
21
Pages with Bias
47.7%
Bias Rate

Bias Trend Over Time

Pages with Bias Issues

200 issues found
Showing 26-50 of 200 flagged pages
Azure Relay Expose on-premises WCF REST service to clients ...ain/articles/azure-relay/service-bus-relay-tutorial.md
High Priority View Details →
Scanned: 2026-01-12 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily biased towards Windows environments. All examples and instructions assume the use of Visual Studio (a Windows-centric IDE), and there is no mention of Linux or cross-platform development tools. Steps such as 'Run as administrator', project creation, NuGet package installation, and configuration are described exclusively using Windows/Visual Studio workflows. There are no alternative instructions or code samples for Linux users, nor any mention of how to use .NET Core/SDK CLI tools, which are cross-platform. The use of Windows-specific terminology and tools (e.g., Solution Explorer, Visual Studio, App.config, WindowsAzure.ServiceBus NuGet package) further reinforces the Windows bias.
Recommendations
  • Add instructions for using .NET Core/SDK CLI tools (dotnet new, dotnet add package, dotnet build) for project creation and package management, which work on Linux, macOS, and Windows.
  • Include examples and screenshots for popular Linux IDEs (e.g., VS Code) or command-line workflows.
  • Clarify which steps are platform-agnostic and which are Windows-specific; provide Linux/macOS equivalents where possible.
  • Mention that WCF is supported on .NET Framework (Windows-only) and clarify cross-platform alternatives (e.g., gRPC, ASP.NET Core Web APIs) for Linux users.
  • Provide troubleshooting notes for running WCF services on Linux via Mono (if possible), or suggest alternatives for Linux environments.
  • Avoid using Windows-centric language (e.g., 'Run as administrator') without offering Linux/macOS equivalents (e.g., 'use sudo').
GitHub Create Pull Request
Azure Relay Authenticate from an application - Azure Relay .../main/articles/azure-relay/authenticate-application.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example Dotnet Heavy
Summary
The documentation page demonstrates a bias towards Windows environments by primarily featuring .NET (C#) code samples and console applications, which are most commonly run on Windows. The instructions for running sample applications reference .NET and do not provide explicit guidance or examples for Linux environments or cross-platform usage. There is no mention of Linux-specific tools, patterns, or troubleshooting, and the highlighted code is exclusively in C#. While Java and JavaScript samples are linked, the walkthrough and code focus on .NET, which is traditionally Windows-centric.
Recommendations
  • Add explicit instructions and examples for running the sample applications on Linux, including any required dependencies or environment setup.
  • Provide highlighted code samples in Java and JavaScript, not just .NET, to demonstrate cross-platform usage.
  • Include troubleshooting or notes for common Linux scenarios, such as authentication issues or environment variables.
  • Clarify that .NET Core/.NET 6+ is cross-platform and provide steps for running .NET samples on Linux/macOS.
  • Balance the documentation by alternating or paralleling Windows and Linux instructions, especially for steps involving the Azure portal, CLI, or application registration.
GitHub Create Pull Request
Azure Relay Tutorial: REST tutorial using Azure Relay ...rticles/azure-relay/service-bus-relay-rest-tutorial.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The tutorial is heavily oriented toward Windows development. It exclusively uses Windows-specific technologies (WCF, .NET Framework, Visual Studio), and all instructions and examples assume a Windows environment. There are no Linux or cross-platform alternatives mentioned, nor are there instructions for using Linux tools, editors, or SDKs. The documentation assumes Visual Studio and Windows file paths, and does not provide parity for Linux users.
Recommendations
  • Add instructions and examples for building and running the service on Linux, using .NET Core/.NET 6+ and cross-platform editors like VS Code.
  • Include steps for installing the Azure SDK and dependencies on Linux (e.g., using apt, yum, or dotnet CLI).
  • Provide alternative code samples that use cross-platform APIs and avoid Windows-only libraries (e.g., System.Drawing is not supported on Linux by default).
  • Mention and demonstrate how to run and debug the service using command-line tools (dotnet CLI) rather than relying solely on Visual Studio.
  • Clarify any platform-specific limitations of WCF and Azure Relay, and suggest modern, cross-platform alternatives (such as ASP.NET Core with Azure Relay or REST endpoints).
  • Include Linux file system paths and instructions for running the executable on Linux (e.g., using terminal commands).
  • Explicitly state the platform requirements and provide guidance for non-Windows users at the beginning of the tutorial.
GitHub Create Pull Request
Azure Relay Expose on-premises WCF REST service to clients ...ain/articles/azure-relay/service-bus-relay-tutorial.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily focused on Windows development environments and tools. All examples use Visual Studio (Windows-only), and instructions reference Windows-specific UI and workflows (e.g., 'Run as administrator', Solution Explorer, Visual Studio project templates). There are no examples or guidance for Linux or cross-platform development (e.g., .NET CLI, VS Code, or running on Linux/Mac). The tutorial assumes a Windows-centric workflow throughout, with no mention of Linux equivalents or alternatives.
Recommendations
  • Add instructions for using .NET Core/.NET CLI to create and run projects, which work on Linux and Mac.
  • Include examples for setting up and running the service and client using VS Code or command-line tools, not just Visual Studio.
  • Clarify which steps are Windows-specific and provide Linux/Mac alternatives (e.g., file paths, running as administrator/sudo).
  • Mention cross-platform compatibility of WCF (where applicable) and Azure Relay, and provide troubleshooting tips for non-Windows environments.
  • Provide sample commands for installing dependencies (e.g., dotnet add package) and running applications on Linux/Mac.
GitHub Create Pull Request
Azure Relay WCF Relay hybrid on-premises/cloud application (.NET) ...ps://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/service-bus-dotnet-hybrid-app-using-service-bus-relay.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily biased toward Windows development environments. All examples use Visual Studio (Windows-only), .NET Framework (not .NET Core), and Windows-specific project templates. There are no instructions or examples for Linux or cross-platform development, nor any mention of Linux tools or alternatives. The tutorial assumes the reader is using Windows and does not provide parity for Linux users.
Recommendations
  • Add instructions for setting up the development environment on Linux, including using VS Code or JetBrains Rider, and .NET Core/6/8 instead of .NET Framework.
  • Provide equivalent examples for Linux, such as using the dotnet CLI to create and run projects, and instructions for installing the Azure SDK on Linux.
  • Mention cross-platform NuGet packages and ensure code samples work with .NET Core/6/8.
  • Include steps for running the sample applications on Linux, including troubleshooting tips for common Linux issues.
  • Avoid assuming Visual Studio is the only development tool; reference cross-platform editors and IDEs.
  • Clarify which steps are Windows-specific and provide alternatives for Linux/macOS where possible.
GitHub Create Pull Request
Azure Relay Authenticate with managed identities for Azure Relay resources .../articles/azure-relay/authenticate-managed-identity.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates a Windows bias by exclusively using Windows VM examples, referencing Windows-specific instructions (such as RDP and Windows VM creation), and omitting equivalent Linux VM instructions or examples. The sample application walkthrough is tailored for Windows environments, with no mention of Linux VM setup, access, or usage patterns.
Recommendations
  • Add parallel instructions for enabling managed identity on Linux VMs, including links to relevant Linux documentation.
  • Provide Linux-based examples for downloading, building, and running the sample application (e.g., using SSH instead of RDP, Linux build commands).
  • Include guidance for connecting to Azure VMs running Linux, referencing Linux-specific tools and patterns.
  • Ensure that sample code and walkthroughs are platform-agnostic or offer both Windows and Linux variants.
  • Highlight cross-platform compatibility in the sample application section, and clarify any platform-specific requirements.
GitHub Create Pull Request
Azure Relay Azure Relay API overview | Microsoft Docs ...s/blob/main/articles/azure-relay/relay-api-overview.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates a Windows bias by prioritizing Windows-specific technologies (such as .NET Framework and WCF) and omitting explicit Linux or cross-platform usage examples. The .NET Framework library is described in detail with references to Windows Communication Foundation (WCF), a Windows-centric technology, while there is no mention of Linux-specific usage, deployment, or alternative tools. The examples and explanations focus on Windows tools and patterns, and do not provide parity for Linux users.
Recommendations
  • Add explicit examples and instructions for using Azure Relay APIs on Linux, including installation and runtime environments for .NET Core/.NET Standard.
  • Include cross-platform usage scenarios, such as running .NET Standard libraries on Linux or macOS.
  • Mention Linux equivalents or alternatives to Windows-specific technologies (e.g., alternatives to WCF for Linux environments).
  • Provide guidance for deploying and running Node.js and .NET applications using Azure Relay on Linux systems.
  • Balance the documentation by presenting Windows and Linux instructions side-by-side where relevant.
GitHub Create Pull Request
Azure Relay Configure IP firewall for Azure Relay namespace ...n/articles/azure-relay/ip-firewall-virtual-networks.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example Powershell Heavy
Summary
The documentation page demonstrates Windows bias by referencing deployment instructions that point to PowerShell (a Windows-centric tool) without mentioning Linux alternatives. There are no CLI or Bash examples, and the only explicit deployment guidance links to a PowerShell-specific page. No Linux tools or cross-platform CLI instructions are provided for deploying the Resource Manager template.
Recommendations
  • Add Azure CLI and Bash examples for deploying Resource Manager templates, alongside PowerShell instructions.
  • Explicitly mention that deployment can be performed from Linux, macOS, or Windows, and provide platform-agnostic guidance.
  • Include links to documentation for Azure CLI and REST API template deployment methods.
  • Ensure that all examples and instructions are presented in a cross-platform manner, or provide parallel instructions for both Windows and Linux users.
GitHub Create Pull Request
Azure Relay Integrate Azure Relay with Azure Private Link Service ...blob/main/articles/azure-relay/private-link-service.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation demonstrates a Windows bias by providing only Windows-based examples for validation (creating and connecting to a Windows VM), using Azure PowerShell exclusively for CLI instructions, and referencing Windows tools (nslookup in Windows CMD) without mentioning Linux equivalents. There are no examples or instructions for Linux users, such as using Azure CLI, Bash, or Linux VM creation and validation.
Recommendations
  • Add parallel instructions and examples for Linux users, including how to create and validate with a Linux VM.
  • Provide Azure CLI (az) command examples alongside Azure PowerShell for resource creation and management.
  • Include Linux shell commands (e.g., nslookup, dig) for DNS validation, and clarify that these can be run on both Windows and Linux.
  • Reference both Windows and Linux VM creation guides in the validation section.
  • Ensure screenshots and UI instructions are platform-neutral or provide Linux-specific alternatives where relevant.
GitHub Create Pull Request
Azure Relay Azure Relay Hybrid Connections - WebSockets in .NET ...e-relay/relay-hybrid-connections-dotnet-get-started.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
🔧 Windows Tools Missing Linux Example Windows First
Summary
The documentation demonstrates a Windows bias by exclusively referencing Visual Studio (a Windows-centric IDE) for development, omitting any mention of Linux-compatible tools or workflows. All examples and instructions assume a Windows environment, with no guidance for Linux users on alternative editors, .NET installation, or running the applications. The tutorial does not provide parity for Linux users wishing to follow along.
Recommendations
  • Include instructions for installing .NET SDK and running .NET console applications on Linux (e.g., using VS Code, JetBrains Rider, or command-line tools).
  • Provide Linux-specific steps for creating and running the applications, such as using 'dotnet new console', 'dotnet run', and relevant package installation commands.
  • Mention cross-platform compatibility of .NET Core/.NET 5+ and clarify that the tutorial can be followed on Linux and macOS, not just Windows.
  • Add screenshots or terminal output examples from Linux environments.
  • Reference Linux package managers (apt, yum, etc.) for installing .NET and related dependencies.
GitHub Create Pull Request
Azure Relay What is Azure Relay? | Microsoft Docs ...ocs/blob/main/articles/azure-relay/relay-what-is-it.md
High Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
🔧 Windows Tools Windows First Missing Linux Example
Summary
The documentation page demonstrates a moderate Windows bias, primarily through its emphasis on WCF Relay (a Windows/.NET Framework technology) and the absence of explicit Linux or cross-platform examples for WCF Relay. The quick starts and samples for Hybrid Connections do include Node.js and Java, which are cross-platform, but WCF Relay is presented as a legacy/primary feature with only Windows-centric tooling and examples. There is no mention of Linux equivalents or how to use WCF Relay from non-Windows environments.
Recommendations
  • Add explicit guidance or examples for using Azure Relay (especially WCF Relay) from Linux environments, if supported.
  • Clarify platform requirements and limitations for WCF Relay, including whether it can be used from Linux or only Windows.
  • Provide parity in quick starts and samples for Linux users, such as instructions for running .NET Core or Node.js clients on Linux.
  • Consider listing cross-platform options before or alongside Windows-specific technologies to avoid Windows-first ordering.
  • If WCF Relay is Windows-only, make this clear and direct Linux users to Hybrid Connections or other alternatives.
GitHub Create Pull Request
Azure Relay Configure IP firewall for Azure Relay namespace ...n/articles/azure-relay/ip-firewall-virtual-networks.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example Powershell Heavy
Summary
The documentation page demonstrates Windows bias by referencing deployment instructions that link to PowerShell-based guidance, without providing equivalent Linux or cross-platform CLI examples. There is no mention of Linux tools or Azure CLI usage, and the only explicit deployment method refers to a Windows-centric workflow.
Recommendations
  • Add instructions for deploying Resource Manager templates using Azure CLI, which is cross-platform and commonly used on Linux.
  • Include examples or links for using Bash scripts or Linux shell environments to configure firewall rules.
  • Ensure that references to deployment guides include both PowerShell (Windows) and Azure CLI (Linux/macOS) options, or provide a neutral landing page that covers all platforms.
  • Explicitly mention that the Azure portal and Resource Manager templates can be used from any OS, and provide guidance for Linux/macOS users where appropriate.
GitHub Create Pull Request
Azure Relay Authenticate from an application - Azure Relay .../main/articles/azure-relay/authenticate-application.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example Dotnet Heavy
Summary
The documentation page demonstrates a Windows/.NET bias by exclusively providing .NET (C#) code samples and referencing console applications that are most commonly run on Windows. The main sample is for .NET, with no explicit Linux or cross-platform instructions, and there is no mention of Linux-specific setup, tools, or troubleshooting. While Java and JavaScript samples are linked, the walkthrough and highlighted code focus solely on .NET, which is traditionally associated with Windows environments.
Recommendations
  • Add explicit instructions for running the sample applications on Linux, including any prerequisites (e.g., .NET Core/SDK installation, Mono, etc.).
  • Provide equivalent code samples in Java and JavaScript inline, not just as links, to demonstrate parity and cross-platform support.
  • Include a section or notes on platform compatibility, clarifying that the .NET samples can run on Linux and macOS using .NET Core.
  • Add troubleshooting tips for Linux users (e.g., common permission issues, environment variable setup).
  • Mention Linux tools (such as Azure CLI) before or alongside Windows tools (such as PowerShell) when discussing role assignment and management.
GitHub Create Pull Request
Azure Relay Authenticate with managed identities for Azure Relay resources .../articles/azure-relay/authenticate-managed-identity.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates a Windows bias by exclusively providing instructions and examples for Windows VMs, referencing Windows-specific tools (RDP), and omitting equivalent steps or guidance for Linux VMs. All sample walkthroughs assume a Windows environment, with no mention of Linux VM setup, access, or parity in tooling.
Recommendations
  • Add parallel instructions for enabling managed identity on Linux VMs, linking to relevant Linux documentation.
  • Include guidance for connecting to Linux VMs (e.g., SSH) alongside RDP for Windows.
  • Provide sample walkthroughs for running the sample applications on Linux VMs, including build and execution steps.
  • Reference Linux VM quick-create documentation in addition to Windows VM documentation.
  • Ensure code samples and tooling instructions are platform-agnostic or provide both Windows and Linux variants.
GitHub Create Pull Request
Azure Relay Azure Relay API overview | Microsoft Docs ...s/blob/main/articles/azure-relay/relay-api-overview.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates a Windows bias by prioritizing .NET Framework (Windows-only) and Windows Communication Foundation (WCF) Relay in its API overview. It mentions Windows-specific tools and protocols (WCF, net.tcp) without providing equivalent Linux examples or alternatives. There is no mention of Linux-specific usage patterns, nor are there examples or guidance for Linux environments, especially for .NET usage outside Windows.
Recommendations
  • Add explicit examples and guidance for using Azure Relay APIs on Linux, especially with .NET Core/.NET Standard.
  • Include Linux-specific instructions or notes where Windows-only features (e.g., WCF Relay) are mentioned.
  • Highlight cross-platform capabilities and clarify which features are available on Linux and macOS.
  • Provide parity in documentation structure by listing Linux-compatible tools and usage patterns alongside Windows ones.
  • Add sample code or walkthroughs for Linux environments (e.g., running .NET Standard Relay client on Ubuntu).
GitHub Create Pull Request
Azure Relay Integrate Azure Relay with Azure Private Link Service ...blob/main/articles/azure-relay/private-link-service.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates a Windows bias by providing only Windows-centric examples and instructions. The only CLI example uses Azure PowerShell, with no Bash, Azure CLI, or Linux shell equivalents. The validation step explicitly instructs users to create a Windows VM, with no mention of Linux VMs or cross-platform alternatives. All screenshots and portal instructions are generic, but command-line and VM instructions are Windows-specific, and there is no guidance for Linux users.
Recommendations
  • Add Azure CLI (az) examples alongside or instead of Azure PowerShell, as Azure CLI is cross-platform and widely used on Linux and macOS.
  • Include instructions for creating and validating with a Linux VM (e.g., Ubuntu), and provide equivalent shell commands (such as nslookup) for Linux.
  • Where possible, use generic terminology (e.g., 'command line' instead of 'PowerShell') and clarify that steps apply to both Windows and Linux unless platform-specific.
  • Add notes or sections highlighting any platform-specific differences or considerations for Linux users.
  • Ensure parity in troubleshooting and validation steps for both Windows and Linux environments.
GitHub Create Pull Request
Azure Relay What is Azure Relay? | Microsoft Docs ...ocs/blob/main/articles/azure-relay/relay-what-is-it.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
🔧 Windows Tools Windows First Missing Linux Example
Summary
The documentation page demonstrates a moderate Windows bias, primarily through its emphasis on WCF Relay, which is a Windows/.NET Framework technology, and the absence of explicit Linux or cross-platform setup examples for WCF Relay. All WCF Relay quick starts and samples are .NET Framework/WCF-centric, which are Windows-first technologies. While Hybrid Connections are described as cross-platform and open-standard, the documentation does not provide parity in examples or guidance for Linux environments, especially for WCF Relay scenarios.
Recommendations
  • Add explicit Linux setup and usage examples for Azure Relay, especially for WCF Relay scenarios (if possible with .NET Core or other cross-platform frameworks).
  • Include instructions or quick starts for using Azure Relay from Linux environments, such as with Mono, .NET Core, or alternative technologies.
  • Clearly indicate platform compatibility and limitations for each feature, especially where WCF Relay is Windows-only.
  • Provide parity in tooling and troubleshooting guidance for both Windows and Linux users.
  • Highlight open-source or cross-platform client libraries and tools where available, and link to relevant documentation.
GitHub Create Pull Request
Azure Relay Azure Relay Hybrid Connections - WebSockets in .NET ...e-relay/relay-hybrid-connections-dotnet-get-started.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation demonstrates a Windows bias by exclusively referencing Visual Studio (a Windows-centric IDE) for development and running C# console applications, with no mention of Linux development environments or instructions for running the applications on Linux. All examples and instructions assume a Windows workflow, and there are no alternative steps or tooling suggestions for Linux users.
Recommendations
  • Include instructions for developing and running the .NET applications on Linux (e.g., using VS Code, JetBrains Rider, or the 'dotnet' CLI).
  • Provide example commands for building and running the applications using the .NET Core/SDK CLI, which is cross-platform.
  • Mention Linux prerequisites, such as installing the .NET SDK on Ubuntu or other distributions.
  • Add screenshots or terminal output examples from Linux environments.
  • Clarify that the tutorial is applicable to both Windows and Linux, and note any platform-specific differences.
GitHub Create Pull Request
Azure Relay WCF Relay hybrid on-premises/cloud application (.NET) ...ps://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/service-bus-dotnet-hybrid-app-using-service-bus-relay.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 4 bias types
Detected Bias Types
Windows First Missing Linux Example Powershell Heavy 🔧 Windows Tools
Summary
The documentation is heavily biased toward Windows development environments. All examples and instructions assume the use of Visual Studio on Windows, with no mention of Linux or cross-platform alternatives. The tutorial relies on Windows-specific tools (Visual Studio, .NET Framework, WCF), and does not provide guidance for Linux users or alternative development workflows. There are no Linux or macOS instructions, nor are there any examples using cross-platform .NET (Core/6+) or command-line tools that work outside Windows.
Recommendations
  • Add instructions for setting up the development environment on Linux and macOS, including using Visual Studio Code, JetBrains Rider, or command-line tools.
  • Provide examples using .NET Core or .NET 6+, which are cross-platform, instead of (or in addition to) .NET Framework.
  • Include steps for building and running the sample applications using the dotnet CLI, which works on all platforms.
  • Mention and demonstrate how to use Azure Relay with Linux-hosted services, possibly using Docker containers or other cross-platform hosting options.
  • Clarify which steps are Windows-specific and provide equivalent steps for Linux (e.g., package installation, running as administrator, project creation).
  • If WCF is required, note its limitations on non-Windows platforms and suggest alternatives where possible.
GitHub Create Pull Request
Azure Relay Expose on-premises WCF REST service to clients ...ain/articles/azure-relay/service-bus-relay-tutorial.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation is heavily oriented towards Windows development environments. All examples use Visual Studio (a Windows-centric IDE), and instructions reference Windows-specific workflows (e.g., 'Run as administrator', Solution Explorer, project property pages). There are no examples or guidance for Linux users, such as using .NET Core/SDK on Linux, cross-platform editors, or command-line alternatives. The documentation assumes a Windows environment throughout and omits Linux equivalents for project setup, building, and running the applications.
Recommendations
  • Add instructions for setting up and running the tutorial using .NET Core/SDK on Linux, including project creation and build steps via the dotnet CLI.
  • Include examples using cross-platform editors such as VS Code, and clarify that the code can be built and run on Linux and macOS as well as Windows.
  • Provide alternative steps for installing dependencies (e.g., NuGet packages) using the command line, not just Visual Studio GUI.
  • Mention any platform-specific considerations for running WCF on non-Windows platforms, and link to relevant documentation.
  • Ensure screenshots and references to UI elements are supplemented with equivalent command-line instructions.
GitHub Create Pull Request
Azure Relay Tutorial: REST tutorial using Azure Relay ...rticles/azure-relay/service-bus-relay-rest-tutorial.md
High Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The tutorial is heavily oriented toward Windows development, specifically using Visual Studio and WCF, with no mention of Linux-compatible tools, workflows, or alternative approaches. All instructions and code samples assume a Windows environment, and there are no examples or guidance for Linux users or cross-platform development.
Recommendations
  • Provide instructions for setting up the development environment on Linux, including using .NET Core/SDK and compatible editors (e.g., VS Code, JetBrains Rider).
  • Include Linux-specific steps for installing prerequisites, such as using apt/yum/pacman for .NET SDK installation.
  • Offer cross-platform code samples using .NET Core (now .NET 6/7/8), which runs on Windows, Linux, and macOS.
  • Mention and demonstrate how to run and debug the application from the command line (dotnet CLI) rather than relying solely on Visual Studio.
  • Clarify which features (such as WCF) are Windows-only and suggest alternatives for Linux, such as ASP.NET Core with Azure Relay.
  • Add troubleshooting notes for Linux users, including file system differences, permissions, and environment setup.
  • Reference Linux-friendly Azure management tools (e.g., Azure CLI) for resource creation and configuration.
GitHub Create Pull Request
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-hybrid-connections-dotnet-get-started.md ...e-relay/relay-hybrid-connections-dotnet-get-started.md
High Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation demonstrates a bias towards Windows by exclusively referencing Visual Studio (a Windows-centric IDE) for development, and does not mention or provide examples for Linux development environments or tools. There are no instructions or examples for running the .NET applications on Linux, nor any mention of cross-platform .NET Core/SDK usage. The tutorial assumes a Windows workflow throughout.
Recommendations
  • Include instructions for setting up and running the .NET applications on Linux using .NET Core/SDK and cross-platform editors like VS Code.
  • Provide Linux-specific commands and examples for building and running the applications (e.g., using the dotnet CLI).
  • Mention alternative development environments, such as JetBrains Rider or VS Code, which are available on Linux.
  • Clarify that .NET Core/.NET 6+ is cross-platform and provide guidance for non-Windows users.
  • Add screenshots or terminal output examples from Linux environments.
GitHub Create Pull Request
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/ip-firewall-virtual-networks.md ...n/articles/azure-relay/ip-firewall-virtual-networks.md
High Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Powershell Heavy Missing Linux Example
Summary
The documentation page demonstrates Windows bias by referencing Azure portal and Resource Manager template deployment instructions that link specifically to PowerShell-based guidance, without mentioning or providing equivalent Linux or cross-platform CLI instructions. There are no examples using Azure CLI, Bash, or Linux-native tools, and the deployment workflow assumes familiarity with Windows-centric tooling.
Recommendations
  • Add explicit instructions and examples for deploying Resource Manager templates using Azure CLI (az deployment), which is cross-platform and widely used on Linux.
  • Include Bash shell examples for common tasks, such as querying IP addresses or manipulating JSON templates.
  • Reference both Windows and Linux environments when discussing deployment options, and avoid linking exclusively to PowerShell-based documentation.
  • Where screenshots or UI references are made, clarify that the Azure portal is accessible from any OS/browser, and provide parity for command-line workflows.
  • Consider a dedicated section or callout for Linux users, summarizing equivalent steps and tools.
GitHub Create Pull Request
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/authenticate-application.md .../main/articles/azure-relay/authenticate-application.md
High Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example Dotnet Heavy
Summary
The documentation page primarily focuses on .NET and C# examples, which are most commonly associated with Windows development environments. The main sample provided is a .NET console application, and the instructions and highlighted code are exclusively in C#. There are no explicit Linux or cross-platform command-line instructions, nor are there examples for running the sample on Linux or with non-Windows tools. While there are links to Java and JavaScript samples, the walkthrough and code focus solely on .NET, potentially making it less accessible to Linux-first or cross-platform developers.
Recommendations
  • Include explicit instructions for running the sample applications on Linux (e.g., using .NET Core/SDK on Linux, or Java/Node.js samples).
  • Provide code walkthroughs or highlighted code for at least one non-.NET sample (e.g., Java or JavaScript), demonstrating parity in authentication flows.
  • Add command-line instructions using Azure CLI for all relevant steps (e.g., app registration, role assignment), and clarify that these commands work cross-platform.
  • Mention that the .NET sample can be run on Linux using .NET Core/SDK, and provide any necessary prerequisites or troubleshooting tips for Linux users.
  • Balance the documentation by alternating or paralleling Windows and Linux tool references, rather than focusing on Windows-first patterns.
GitHub Create Pull Request
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/authenticate-managed-identity.md .../articles/azure-relay/authenticate-managed-identity.md
High Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 3 bias types
Detected Bias Types
Windows First Missing Linux Example 🔧 Windows Tools
Summary
The documentation page demonstrates a Windows bias by exclusively using Windows VM examples, referencing Windows-specific tools (RDP), and omitting Linux VM instructions or parity. All step-by-step guidance assumes a Windows environment, and there are no Linux-specific examples or mentions of Linux tools or workflows.
Recommendations
  • Add parallel instructions for enabling managed identity on Linux VMs, referencing the appropriate Azure documentation.
  • Include examples for connecting to Linux VMs (e.g., SSH) instead of only mentioning RDP for Windows.
  • Provide sample walkthroughs for running the sample applications on Linux VMs, including build and execution steps.
  • Clarify that the process is cross-platform and highlight any differences or additional steps required for Linux environments.
  • Ensure that code samples and links to sample applications include Linux compatibility notes or instructions where relevant.
GitHub Create Pull Request
← Previous Page 2 of 8 Next →