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 does not provide any explicit Linux-specific instructions, nor does it mention or demonstrate how to perform the same tasks in a Linux-native environment (e.g., using Linux terminal, editors, or deployment patterns). There are no PowerShell-specific commands, but the overall workflow is Windows/Microsoft-centric, and Linux users are left to infer compatibility.
Recommendations:
- Explicitly state that all CLI commands (dotnet, azd) work on Linux, macOS, and Windows, and provide any necessary prerequisites for Linux (e.g., installing .NET SDK, Azure CLI).
- Include Linux-specific instructions or notes, such as how to open the app in a browser from a Linux terminal, or how to run and debug the app using common Linux editors (VS Code, Vim, etc.).
- Mention how to deploy from a local Linux environment, not just from Codespaces or GitHub Actions.
- If referencing file paths, use forward slashes or clarify path conventions for both Windows and Linux.
- Add a section or callout confirming that all steps are cross-platform, and link to official .NET and Azure CLI installation guides for Linux.
Create pull request