Detected Bias Types
Windows First
Missing Linux Example
🔧
Windows Tools
Summary
The documentation is heavily oriented toward Windows development environments, specifically Visual Studio and IIS Express. All instructions and examples assume use of Visual Studio on Windows, with no mention of Linux or macOS alternatives, such as VS Code, JetBrains Rider, or command-line workflows. There are no instructions for running or deploying the app from Linux/macOS, and no guidance for using cross-platform .NET Core/ASP.NET Core projects. The documentation also references IIS Express, a Windows-only tool, and omits Linux-friendly web servers (e.g., Kestrel, Nginx, Apache).
Recommendations
- Add instructions for creating and running the ASP.NET app using cross-platform tools like VS Code or JetBrains Rider.
- Include examples for running the app locally using Kestrel (the default cross-platform ASP.NET web server) instead of or in addition to IIS Express.
- Provide Linux/macOS-specific steps for installing dependencies, running, and deploying the app.
- Clarify whether the sample works with ASP.NET Core (cross-platform) or only with ASP.NET Framework (Windows-only), and provide parity where possible.
- Add command-line instructions (dotnet CLI) for building, running, and publishing the app.
- Mention Azure deployment options that do not require Visual Studio, such as Azure CLI or GitHub Actions.