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 176-200 of 200 flagged pages
Azure Relay Hybrid Connections - HTTP requests in .NET ...ay-hybrid-connections-http-requests-dotnet-get-started.md
Medium Priority View Details →
Scanned: 2026-01-11 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a Windows bias by exclusively referencing Visual Studio (a Windows-centric IDE) for development and running the .NET console applications. There are no instructions or examples for Linux users, such as using VS Code, the dotnet CLI, or running the applications on Linux. The tutorial assumes a Windows environment throughout, without mentioning cross-platform alternatives.
Recommendations
  • Add instructions for creating and running the .NET applications using the dotnet CLI, which works on Linux and macOS.
  • Include examples of using VS Code as an alternative to Visual Studio, with steps for Linux users.
  • Explicitly state that the .NET code can be run on Linux and macOS, and provide any necessary platform-specific notes.
  • Provide screenshots or terminal commands for Linux environments where relevant.
  • Clarify any prerequisites or dependencies that differ on Linux (e.g., installing .NET SDK, using terminal instead of console window).
Azure Relay Hybrid Connections - HTTP requests in .NET ...ay-hybrid-connections-http-requests-dotnet-get-started.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a Windows bias by exclusively referencing Visual Studio (a primarily Windows IDE) for development and running .NET console applications, with no mention of Linux-compatible development environments or instructions for running the applications on Linux. There are no examples or guidance for using cross-platform .NET tools (such as VS Code or the dotnet CLI) or for Linux users.
Recommendations
  • Include instructions for using cross-platform development tools such as Visual Studio Code and the dotnet CLI.
  • Add explicit steps for running the .NET applications on Linux and macOS, including any necessary environment setup.
  • Provide alternative examples for creating and running the applications outside of Visual Studio, such as using terminal commands.
  • Mention platform compatibility for .NET applications and clarify that the code can run on Windows, Linux, and macOS.
  • If screenshots or UI instructions are included, provide Linux/macOS equivalents where relevant.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md ...https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively references Visual Studio and .NET Framework for creating the console application, which are traditionally Windows-centric development environments. There are no instructions or examples for Linux users, such as using .NET Core/.NET 6+ with cross-platform editors (VS Code, JetBrains Rider) or command-line tools (dotnet CLI). The NuGet package installation is described only via Visual Studio's GUI, omitting CLI alternatives. No mention is made of Linux-specific considerations or parity.
Recommendations
  • Include instructions for creating the project using the dotnet CLI (e.g., 'dotnet new console') for cross-platform compatibility.
  • Mention and provide examples for using VS Code or other cross-platform editors.
  • Describe how to install NuGet packages using the CLI (e.g., 'dotnet add package Microsoft.Azure.Relay').
  • Clarify that the code works on .NET Core/.NET 6+ and is cross-platform, not just .NET Framework.
  • Add notes or sections for Linux/macOS users, including any OS-specific setup or troubleshooting.
  • Avoid assuming Visual Studio is the only development environment; present alternatives equally.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md ...https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and provides step-by-step instructions that assume a Windows development environment. There are no examples or guidance for Linux users, such as using .NET Core/SDK with VS Code or command-line tools, nor is there mention of Linux-compatible workflows for project creation or package management.
Recommendations
  • Add instructions for creating the console application using .NET Core/.NET (cross-platform) via the command line (e.g., 'dotnet new console') and/or using VS Code.
  • Include NuGet package installation steps using the 'dotnet add package' CLI command, which works on Linux, macOS, and Windows.
  • Clarify that the sample code works on Linux and macOS as well as Windows, and note any platform-specific considerations.
  • Provide example commands and screenshots for Linux environments, such as Ubuntu, to demonstrate parity.
  • Avoid assuming Visual Studio is the only development environment; mention alternatives like VS Code and JetBrains Rider.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-client.md ...id-connections-http-requests-dotnet-get-started-client.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and provides instructions tailored to Windows development workflows. There are no examples or guidance for Linux users, such as using .NET Core/SDK on Linux, alternative editors, or cross-platform development patterns.
Recommendations
  • Add instructions for creating the application using .NET Core/.NET SDK via command line, which works on Linux, macOS, and Windows.
  • Include examples for using cross-platform editors like VS Code or JetBrains Rider.
  • Provide Linux-specific steps for installing the Azure Relay NuGet package (e.g., using 'dotnet add package' command).
  • Clarify that the code sample works on Linux and macOS if using .NET Core/.NET 6+.
  • Mention any platform-specific considerations for running the sample on non-Windows systems.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-server.md ...id-connections-http-requests-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2026-01-10 00:00
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and provides instructions that assume a Windows development environment. There are no examples or guidance for Linux users, such as using .NET Core/.NET 6+ (cross-platform), alternative editors (VS Code, JetBrains Rider), or command-line workflows (dotnet CLI).
Recommendations
  • Add instructions for creating a cross-platform .NET console application using the dotnet CLI (e.g., 'dotnet new console').
  • Include examples for using VS Code or other cross-platform editors.
  • Clarify whether the Azure Relay SDK and sample code work on Linux/macOS, and provide any necessary platform-specific notes.
  • Provide Linux/macOS installation steps for the NuGet package (e.g., 'dotnet add package Microsoft.Azure.Relay').
  • Avoid assuming Visual Studio or .NET Framework; recommend .NET 6+ or .NET Core for cross-platform compatibility.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md ...https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md
Medium Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and only provides instructions for using NuGet via the Visual Studio GUI. There are no examples or guidance for Linux users, such as using .NET Core/SDK commands, cross-platform editors, or CLI-based package management. This creates a bias toward Windows development environments and omits Linux development workflows.
Recommendations
  • Add instructions for creating a console application using .NET Core/SDK CLI (e.g., 'dotnet new console') that works on Linux, macOS, and Windows.
  • Include steps for adding the Relay NuGet package using the 'dotnet add package' CLI command.
  • Mention cross-platform editors such as VS Code, and provide guidance for users who do not use Visual Studio.
  • Clarify that the code sample works on .NET Core/.NET 5+ and is not limited to .NET Framework/Windows.
  • Add explicit notes or sections for Linux/macOS users, including any platform-specific considerations.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-server.md ...id-connections-http-requests-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and provides instructions tailored to Windows development workflows. There are no examples or guidance for Linux users, such as using .NET Core/.NET 6+ (cross-platform), command-line tooling (dotnet CLI), or alternative editors (VS Code). The steps assume a Windows environment and do not mention Linux compatibility or alternatives.
Recommendations
  • Add instructions for creating a console application using the dotnet CLI, which works on Linux, macOS, and Windows.
  • Include examples for .NET Core or .NET 6+, which are cross-platform, instead of or in addition to .NET Framework.
  • Mention alternative editors such as Visual Studio Code, which are available on Linux.
  • Clarify any platform-specific requirements or limitations for Azure Relay.
  • Provide explicit steps for installing the NuGet package via the command line (dotnet add package) for Linux users.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md ...https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and provides step-by-step instructions that assume a Windows development environment. There are no references to Linux-compatible workflows, such as using .NET Core/.NET 6+, cross-platform editors (VS Code), or command-line package management (dotnet CLI). No Linux-specific instructions or examples are provided.
Recommendations
  • Include instructions for creating a cross-platform .NET application (e.g., .NET 6+ Console App) that can run on Linux, macOS, and Windows.
  • Provide alternative steps for adding NuGet packages using the dotnet CLI (e.g., 'dotnet add package Microsoft.Azure.Relay') instead of only Visual Studio GUI.
  • Mention and provide examples using cross-platform editors like Visual Studio Code.
  • Clarify that the code samples are compatible with Linux and macOS, or note any platform-specific limitations.
  • Add a section or notes for Linux users, including prerequisites (e.g., installing .NET SDK on Linux), and how to run the application from the terminal.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-client.md ...id-connections-http-requests-dotnet-get-started-client.md
Medium Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation page exclusively describes creating a .NET Framework console application using Visual Studio, a Windows-centric IDE, and provides step-by-step instructions tailored to Windows workflows. There are no examples or guidance for Linux users, such as using .NET Core/SDK on Linux, alternative editors, or command-line workflows. The instructions and code samples assume a Windows development environment, omitting Linux parity.
Recommendations
  • Add instructions for creating a .NET application using the .NET CLI (dotnet new console) that works cross-platform.
  • Include examples for installing the Relay NuGet package via the command line (dotnet add package) instead of only Visual Studio UI.
  • Mention and provide code samples that work with .NET Core/.NET 6+, which are supported on Linux and macOS.
  • Reference alternative editors (e.g., VS Code) and workflows for Linux users.
  • Explicitly state platform compatibility and provide guidance for non-Windows environments.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-hybrid-connections-http-requests-dotnet-get-started.md ...ay-hybrid-connections-http-requests-dotnet-get-started.md
Medium Priority View Details →
Scanned: 2026-01-09 00:34
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation is heavily oriented towards Windows development environments, specifically Visual Studio, with no mention of Linux-compatible tools or workflows. All instructions and examples assume the use of Visual Studio, which is primarily a Windows application. There are no alternative steps or examples for Linux users, such as using VS Code, .NET CLI, or running the applications on Linux.
Recommendations
  • Add instructions for creating and running the .NET applications using cross-platform tools like .NET CLI and Visual Studio Code.
  • Include explicit steps for Linux and macOS users, such as installation of .NET SDK and running console applications from the terminal.
  • Provide example commands for building and running the applications on Linux (e.g., 'dotnet run').
  • Mention that the code works on Linux and macOS, and provide troubleshooting tips for those platforms.
  • Clarify that Visual Studio is optional and suggest alternatives for non-Windows environments.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-client.md ...id-connections-http-requests-dotnet-get-started-client.md
Medium Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a clear Windows bias by exclusively referencing Visual Studio and .NET Framework for creating the console application, with no mention of Linux-compatible development environments or cross-platform .NET Core/.NET 6+. All instructions and code samples assume a Windows development workflow, omitting guidance for Linux users or alternative tooling.
Recommendations
  • Add instructions for creating a console application using .NET Core/.NET 6+ (which is cross-platform) and compatible with Linux and macOS.
  • Include examples for using command-line tools (e.g., dotnet CLI) to create and manage projects, install NuGet packages, and run applications.
  • Mention alternative editors (such as VS Code) and provide steps for Linux users to set up the development environment.
  • Clarify that the code sample works on Linux and macOS, and provide any necessary platform-specific notes.
  • Avoid referencing Visual Studio-specific workflows as the only option; present them alongside cross-platform alternatives.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-server.md ...id-connections-http-requests-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation demonstrates a clear Windows bias by exclusively referencing Visual Studio and the .NET Framework, both of which are traditionally Windows-centric tools. There are no instructions or examples for Linux users, such as using .NET Core/.NET 6+ cross-platform projects, command-line tooling (dotnet CLI), or alternative editors. The steps assume a Windows development environment and do not mention Linux-compatible workflows.
Recommendations
  • Add instructions for creating the console application using the dotnet CLI, which works on Linux, macOS, and Windows.
  • Include examples for .NET Core or .NET 6+ projects instead of only .NET Framework.
  • Mention alternative editors (e.g., VS Code) and how to install NuGet packages via CLI (dotnet add package).
  • Clarify that the code is cross-platform and provide explicit steps for Linux users, including any necessary environment setup.
  • Avoid assuming Visual Studio is the only development environment; provide parity for Linux and macOS users.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-hybrid-connections-http-requests-dotnet-get-started.md ...ay-hybrid-connections-http-requests-dotnet-get-started.md
Medium Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation page demonstrates a bias toward Windows by exclusively referencing Visual Studio (a Windows-centric IDE) for development and omitting instructions or examples for Linux environments. There are no mentions of cross-platform .NET development tools (such as VS Code or CLI), nor are there instructions for running or building the applications on Linux or macOS. All steps assume a Windows workflow.
Recommendations
  • Include instructions for using cross-platform .NET tools, such as the .NET CLI (dotnet new, dotnet run) and Visual Studio Code.
  • Add explicit steps for installing .NET SDK on Linux and macOS.
  • Provide example commands for building and running the applications on Linux (e.g., using terminal/bash).
  • Mention alternative editors (VS Code, JetBrains Rider) that work on Linux and macOS.
  • Clarify that the .NET code is cross-platform and can be run on Linux and macOS, not just Windows.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md ...https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-client.md
Medium Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation assumes use of Visual Studio and .NET Framework, which are primarily Windows-centric tools. All instructions and examples are tailored for Windows development environments, with no mention of Linux-compatible workflows, editors, or .NET Core/.NET 6+ cross-platform options. There are no Linux-specific instructions or alternative tooling suggestions.
Recommendations
  • Add instructions for creating the console application using cross-platform .NET (e.g., .NET 6/7/8) via the 'dotnet' CLI, which works on Linux, macOS, and Windows.
  • Include examples of installing the NuGet package using the CLI: 'dotnet add package Microsoft.Azure.Relay'.
  • Mention alternative editors such as VS Code or JetBrains Rider, which are available on Linux.
  • Clarify that the sample code works on .NET Core/.NET 6+ and is cross-platform, not just .NET Framework.
  • Provide explicit steps for Linux users, such as command-line instructions for project creation, package installation, and running the application.
  • Avoid assuming Visual Studio is the only development environment.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md ...https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2026-01-08 00:53
Reviewed by: LLM Analysis
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation exclusively references Visual Studio and .NET Framework Console App creation, which are Windows-centric tools and workflows. There are no instructions or examples for Linux users, such as using .NET Core/SDK CLI commands, cross-platform editors, or Linux package management. The NuGet package installation is described only via Visual Studio's GUI, omitting CLI alternatives. No mention is made of Linux compatibility or how to run the sample on Linux.
Recommendations
  • Add instructions for creating the console application using the .NET CLI (e.g., 'dotnet new console') for cross-platform support.
  • Include NuGet package installation steps using the CLI (e.g., 'dotnet add package Microsoft.Azure.Relay').
  • Clarify that the code sample works on .NET Core/.NET 6+ and is cross-platform, not just .NET Framework.
  • Mention alternative editors (e.g., VS Code) and Linux development environments.
  • Provide explicit steps for running the application on Linux (e.g., using 'dotnet run' in the terminal).
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-exceptions.md ...ocs/blob/main/articles/azure-relay/relay-exceptions.md
Medium Priority View Details →
Scanned: 2025-07-13 21:37
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Missing Linux Example 🔧 Windows Tools
Summary
The documentation page does not provide any OS-specific examples, but it references .NET APIs and tools (such as ServicePointManager) that are traditionally associated with Windows environments. There are no Linux-specific troubleshooting steps, examples, or mentions of Linux tools or patterns. The guidance assumes a .NET/Windows-centric development environment, which may not be directly applicable to Linux users or those using other languages/platforms.
Recommendations
  • Include troubleshooting steps and examples for Linux environments, such as checking ulimit settings, systemd service logs, or relevant Linux network configuration.
  • Mention cross-platform SDKs and tools (e.g., Azure CLI, Node.js SDK) and provide equivalent guidance for those environments.
  • Clarify when advice is specific to .NET/Windows and offer alternative steps for non-Windows users.
  • Add examples or notes for common Linux firewall configurations and how they might affect Azure Relay connections.
  • Reference platform-agnostic documentation or provide links to language-specific guides for non-Windows platforms.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-hybrid-connections-http-requests-dotnet-get-started.md ...ay-hybrid-connections-http-requests-dotnet-get-started.md
Medium Priority View Details →
Scanned: 2025-07-13 21:37
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation assumes the use of Visual Studio (a primarily Windows-based IDE) for all development steps and does not mention or provide instructions for Linux users or alternative development environments. There are no examples or guidance for running or developing the .NET applications on Linux, nor are cross-platform .NET CLI instructions provided.
Recommendations
  • Include instructions for setting up and running the .NET applications using the .NET CLI (dotnet new, dotnet run, etc.), which works on Linux, macOS, and Windows.
  • Mention and provide examples for using cross-platform editors such as Visual Studio Code.
  • Explicitly state that the tutorial can be followed on Linux and macOS, not just Windows.
  • Add notes or sections for any platform-specific considerations (e.g., how to open/close console windows, install .NET SDK on Linux).
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-dotnet-get-started-server.md ...id-connections-http-requests-dotnet-get-started-server.md
Medium Priority View Details →
Scanned: 2025-07-13 21:37
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation assumes a Windows development environment by instructing users to create the project in Visual Studio and referencing .NET Framework, which is primarily Windows-only. There are no instructions or examples for creating the application on Linux or using cross-platform tools like .NET Core/SDK CLI. The NuGet package installation steps are also Visual Studio-specific, with no mention of command-line alternatives suitable for Linux.
Recommendations
  • Add instructions for creating the console application using the .NET CLI (e.g., 'dotnet new console') for cross-platform compatibility.
  • Mention and provide steps for installing the NuGet package via the CLI (e.g., 'dotnet add package Microsoft.Azure.Relay'), which works on Linux, macOS, and Windows.
  • Clarify whether the code is compatible with .NET Core/.NET 5+ and, if so, recommend using those frameworks for cross-platform support.
  • Include a note or section specifically for Linux/macOS users, outlining any differences or additional steps required.
  • Avoid assuming Visual Studio as the only development environment; reference VS Code or other editors where appropriate.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-hybrid-connections-http-requests-dotnet-get-started.md ...ay-hybrid-connections-http-requests-dotnet-get-started.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Windows First Missing Linux Example
Summary
The documentation assumes the use of Visual Studio (a primarily Windows IDE) and does not mention or provide instructions for Linux or cross-platform development environments. There are no examples or guidance for running or developing the .NET applications on Linux, nor are alternative tools (such as VS Code or command-line .NET CLI) mentioned.
Recommendations
  • Include instructions for setting up and running the .NET applications using cross-platform tools such as Visual Studio Code or the .NET CLI.
  • Explicitly mention that .NET Core/.NET 5+ applications can be developed and run on Linux and macOS, not just Windows.
  • Provide Linux-specific steps or notes where relevant, such as installing the .NET SDK on Linux, and running the applications from the terminal.
  • Avoid assuming Visual Studio as the only development environment; offer alternatives suitable for Linux users.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-port-settings.md .../blob/main/articles/azure-relay/relay-port-settings.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Missing Linux Example
Summary
The documentation focuses exclusively on Windows Communication Foundation (WCF) Relays and .NET bindings, which are primarily Windows-centric technologies. There are no examples or guidance for Linux users, nor is there mention of cross-platform alternatives or how to configure equivalent functionality on Linux systems.
Recommendations
  • Include information about using Azure Relay from non-Windows platforms, such as with .NET Core/.NET 5+ (which is cross-platform) or other supported SDKs.
  • Provide examples or references for configuring required ports and bindings on Linux systems, including common firewall configuration commands (e.g., using iptables, ufw, or firewalld).
  • Mention cross-platform alternatives to WCF, such as gRPC or REST-based approaches, where applicable.
  • Clarify which features or bindings are Windows-only and which are available cross-platform.
  • Add a section or note explicitly addressing Linux/macOS users and linking to relevant setup guides.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-what-is-it.md ...ocs/blob/main/articles/azure-relay/relay-what-is-it.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
🔧 Windows Tools Windows First
Summary
The documentation page shows a moderate Windows bias, primarily through the emphasis on WCF Relay, which is a Windows-specific (WCF/.NET Framework) technology. WCF Relay is described as a core feature and is given equal prominence to the cross-platform Hybrid Connections, despite being Windows-only. All WCF Relay examples and quick starts are Windows-centric, with no Linux equivalents or alternatives mentioned. However, the Hybrid Connections feature is highlighted as cross-platform, and quick starts for Node.js and Java are included, indicating some effort toward Linux parity.
Recommendations
  • Clearly indicate that WCF Relay is Windows/.NET Framework-specific and not available on Linux.
  • Add explicit notes or sections for Linux users, clarifying which features are cross-platform and which are Windows-only.
  • Ensure that cross-platform (Linux-friendly) quick starts and samples are listed before or alongside Windows/.NET-specific ones.
  • Consider providing Linux command-line or scripting examples (e.g., using curl, bash, or other common Linux tools) where relevant.
  • When discussing features, lead with the cross-platform Hybrid Connections and only mention WCF Relay as a legacy or Windows-specific option.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/move-across-regions.md .../blob/main/articles/azure-relay/move-across-regions.md
Medium Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 2 bias types
Detected Bias Types
Missing Linux Example Windows First
Summary
The documentation page exclusively describes the process of moving an Azure Relay namespace using the Azure Portal, with all instructions and screenshots based on the portal's UI. There are no command-line examples (such as Azure CLI, PowerShell, or Bash), nor are there any references to Linux tools or workflows. The only technical reference outside the portal is to Windows Communication Foundation (WCF) relays, a Windows-centric technology. This results in a bias toward Windows and GUI-based workflows, potentially disadvantaging Linux users or those who prefer automation and scripting.
Recommendations
  • Add step-by-step instructions for exporting, editing, and deploying the Resource Manager template using Azure CLI and/or Azure PowerShell, and ensure Azure CLI examples are provided (as it is cross-platform and widely used on Linux).
  • Include sample Bash commands for unzipping the template and editing JSON files, or reference common Linux tools for these tasks.
  • Mention that the Azure Portal is accessible from any OS, but provide parity for users who prefer or require command-line or automated approaches.
  • Clarify the role of WCF relays and, if possible, provide context or alternatives for users not on Windows platforms.
  • Ensure that all screenshots and instructions are not overly specific to Windows UI conventions (e.g., file explorer paths, right-click context menus) and use neutral language where possible.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/includes/relay-hybrid-connections-http-requests-node-get-started-client.md ...brid-connections-http-requests-node-get-started-client.md
Low Priority View Details →
Scanned: 2025-07-13 21:37
Reviewed by: Unknown
Issues: 1 bias type
Detected Bias Types
Windows First
Summary
The documentation refers to running npm install from a 'Node command prompt', which is a Windows-centric term and may imply a Windows-first approach. However, the rest of the instructions and code samples are cross-platform and do not show explicit bias towards Windows or PowerShell. There are no Windows-only tools, commands, or examples, but the terminology could be more inclusive.
Recommendations
  • Replace 'Node command prompt' with 'terminal' or 'command line' to ensure the instructions are clearly applicable to both Windows and Linux users.
  • Explicitly mention that the instructions and code samples work on all major platforms (Windows, Linux, macOS).
  • If there are any platform-specific considerations (such as environment variable syntax), add notes or examples for both Windows and Linux.
Azure Relay https://github.com/MicrosoftDocs/azure-docs/blob/main/articles/azure-relay/relay-hybrid-connections-dotnet-api-overview.md ...-relay/relay-hybrid-connections-dotnet-api-overview.md
Low Priority View Details →
Scanned: 2025-07-08 04:23
Reviewed by: Unknown
Issues: 1 bias type
Detected Bias Types
Missing Linux Example
Summary
The documentation exclusively provides C#/.NET code samples and does not mention or provide any platform-specific instructions, but all examples implicitly assume a Windows/.NET development environment. There are no Linux-specific instructions, examples, or references to cross-platform usage, which may leave Linux developers without guidance on how to use Azure Relay in their environment.
Recommendations
  • Explicitly state that the .NET Standard APIs and code samples are cross-platform and can be used on Linux, macOS, and Windows.
  • Include instructions or notes on how to run the provided .NET code samples on Linux (e.g., using .NET Core/SDK on Linux).
  • If there are any platform-specific considerations (such as firewall configuration, dependencies, or environment variables), document these for Linux users.
  • Provide example commands for building and running the code on Linux (e.g., using 'dotnet build' and 'dotnet run' in a terminal).
  • Link to official Microsoft documentation on installing .NET on Linux.
Previous Page 8 of 8 Next