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 is heavily focused on ASP.NET Core and Visual Studio tooling, which are most commonly used on Windows. While the .NET CLI is cross-platform, the documentation refers to Visual Studio and Visual Studio Code as tabs, but the package installation example for Visual Studio Code uses Install-Package, which is a PowerShell/NuGet Package Manager Console command only available in Visual Studio on Windows, not in VS Code or on Linux/macOS. There are no explicit Linux/macOS instructions or terminal examples, and no mention of Linux-specific considerations (such as file paths, environment variables, or running the app on Linux).
Recommendations:
- Ensure all command-line examples use the cross-platform dotnet CLI (e.g., 'dotnet add package ...') for both Visual Studio and Visual Studio Code, since Install-Package is not available in VS Code or on Linux/macOS.
- Explicitly mention that the instructions apply to Windows, Linux, and macOS, and provide notes for any OS-specific steps or differences (such as file paths, environment variables, or HTTPS development certificates).
- Add a section or callout for running and debugging the application on Linux/macOS, including any prerequisites (e.g., installing the .NET SDK, trusting HTTPS certificates).
- Avoid referencing Windows-specific tools or patterns (such as the Visual Studio Package Manager Console) without providing equivalent cross-platform alternatives.
- Use forward slashes in file paths or note both Windows and Linux/macOS path conventions when referencing files.
Create pull request