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:
⚠️
missing_linux_example
⚠️
windows_tools
⚠️
windows_first
Summary:
The documentation assumes a development workflow centered on .NET, Azure App Service, and GitHub Codespaces, with all examples and instructions tailored to these environments. There are no explicit Linux or cross-platform terminal instructions, and the use of Azure Developer CLI (azd) and .NET CLI is described without clarifying their cross-platform compatibility. The documentation does not mention Linux-specific development environments, nor does it provide parity for Linux users who may not use Codespaces or Visual Studio. The security and deployment sections reference Azure-centric tools and patterns, which are more familiar to Windows/Azure users.
Recommendations:
- Explicitly state that all CLI commands (dotnet, azd) work on Linux, macOS, and Windows, and provide installation links for each OS.
- Include instructions for running the sample app locally on Linux (e.g., using local terminal, VS Code, or JetBrains Rider) in addition to Codespaces.
- Provide alternative deployment instructions for users who do not use GitHub Codespaces, such as using the Azure CLI from a local Linux shell.
- Mention and link to Linux-friendly tools and editors (e.g., VS Code, Vim, Emacs) alongside Codespaces.
- Clarify that Azure App Service and related tools are cross-platform, and highlight any OS-specific considerations.
- If screenshots or UI steps are shown, ensure they are not Windows-specific or provide Linux/macOS equivalents where relevant.
Create pull request