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 configuration (e.g., redirect URI to https://localhost:44316) that aligns with default Windows/IIS Express ports. There are no explicit Linux or cross-platform instructions, nor are there terminal or deployment examples for Linux environments. The documentation does not mention Linux-specific tools, commands, or troubleshooting steps, and does not address potential differences in file paths or environment setup for Linux users.
Recommendations:
- Explicitly mention Linux and macOS as supported platforms in the prerequisites, and provide guidance for installing .NET SDK and running ASP.NET Core apps on those systems.
- Include Linux/macOS-specific instructions for extracting the sample, running the app (e.g., using the dotnet CLI), and troubleshooting common issues (such as port conflicts or permissions).
- Provide examples of configuring the redirect URI for common Linux development environments (e.g., using ports commonly available on Linux, or referencing Kestrel rather than IIS Express).
- Add notes about differences in file paths, environment variables, and permissions between Windows and Linux/macOS.
- Where Visual Studio is mentioned, clarify that Visual Studio Code and the dotnet CLI are fully supported on Linux/macOS, and provide parity in example steps.
Create pull request