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
Summary:
The documentation demonstrates a Windows-first bias by referencing Visual Studio (a Windows-centric IDE) before Visual Studio Code, and by using a sample path and port (https://localhost:44316) that are typical defaults for Visual Studio on Windows. There are no explicit instructions or examples for running the sample on Linux (e.g., using the dotnet CLI, configuring HTTPS certificates, or handling path length limitations on Linux filesystems). No Linux-specific tools, commands, or troubleshooting tips are provided.
Recommendations:
- Provide explicit instructions for running the sample on Linux, including using the dotnet CLI (e.g., 'dotnet run') and handling HTTPS development certificates.
- Mention any Linux-specific prerequisites, such as installing .NET SDK on Ubuntu or other distributions.
- Clarify that Visual Studio Code is cross-platform and provide example commands for both Windows and Linux environments.
- Address path length limitations as they relate to both Windows and Linux, or clarify if this is only a Windows concern.
- Include troubleshooting tips for common Linux issues, such as permissions or certificate trust.
- When listing prerequisites, present cross-platform tools (like Visual Studio Code and dotnet CLI) before or alongside Windows-specific tools.
Create pull request