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 assumes a development environment based on .NET and Azure App Service, with all examples and instructions tailored to ASP.NET Core and related Microsoft tooling. It references GitHub Codespaces and Azure CLI, which are cross-platform, but there are no explicit Linux-specific instructions, troubleshooting, or examples. The workflow and code samples are exclusively for .NET on App Service, with no mention of Linux hosting, deployment, or alternative frameworks. The documentation does not provide parity for Linux users or those using non-Windows environments beyond the implicit support via Codespaces.
Recommendations:
- Add explicit instructions for running and deploying the sample app on Linux (e.g., Ubuntu) using local development environments, including package installation and environment setup.
- Include Linux shell (bash) command examples alongside or instead of generic 'codespace terminal' instructions, clarifying that all steps work on Linux as well as Windows.
- Mention and provide guidance for deploying to Azure App Service for Linux, not just the generic App Service, and clarify any differences.
- Provide troubleshooting tips for common Linux-specific issues (e.g., file permissions, case sensitivity, dependency installation).
- Reference alternative OpenAPI tools or libraries commonly used in Linux/.NET environments, if applicable.
- Ensure that all CLI commands (dotnet, azd) are shown in a way that is clearly cross-platform, and note any OS-specific prerequisites.
Create pull request