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 in prerequisites and usage instructions. There are no explicit Linux-specific instructions or examples, such as using Linux-native editors, command-line tools, or deployment steps. The documentation does not mention or provide guidance for running the sample on Linux, nor does it address potential platform-specific issues (e.g., file permissions, path length limits, HTTPS certificates).
Recommendations:
- Provide explicit instructions for running the sample on Linux, including installation of .NET SDK and use of Linux-native editors (e.g., Vim, Emacs, JetBrains Rider) or command-line tools.
- Include Linux-specific notes for common issues, such as HTTPS certificate trust, file permissions, and path length differences.
- Balance the order of presentation: mention Visual Studio Code (cross-platform) before Visual Studio, or present both options in parallel.
- Add Linux and macOS terminal commands for building and running the sample (e.g., using `dotnet run`), not just references to IDEs.
- Clarify that the sample is cross-platform and provide troubleshooting tips for non-Windows environments.
Create pull request