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 uses .NET Core CLI commands (dotnet build/run), which are cross-platform, but the code blocks are tagged as 'dos', implying a Windows command prompt context. There are no explicit Linux or macOS shell examples, nor is there mention of running the sample on non-Windows platforms. The instructions for editing configuration files reference 'Web.config' (a Windows/IIS convention) in one section, which may confuse Linux users. There is no mention of Linux-specific considerations or parity.
Recommendations:
- Use neutral code block tags (e.g., 'bash', 'shell', or no tag) for dotnet CLI commands to indicate cross-platform compatibility.
- Explicitly mention that the sample and commands work on Windows, Linux, and macOS.
- Provide Linux/macOS shell command examples where appropriate, or clarify that the commands are the same across platforms.
- Avoid references to 'Web.config' unless specifically targeting ASP.NET on Windows; use 'appsettings.json' or other cross-platform configuration files.
- Add a note or section on any platform-specific steps or troubleshooting for Linux/macOS users.
Create pull request