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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation exhibits a mild Windows bias. In several places, Windows-specific tools, settings, and instructions are mentioned before their Linux equivalents, or Linux guidance is less detailed. Some CLI and deployment examples focus on Windows or mention Windows-specific options first. There are also areas where Linux-specific instructions are less prominent or absent, such as ReadyToRun guidance and debugging steps.
Recommendations:
- Ensure all CLI and deployment instructions are provided for both Windows and Linux, with equal detail and prominence.
- When listing platform-specific settings (e.g., netFrameworkVersion for Windows, linuxFxVersion for Linux), present them together or in parallel tabbed sections, not with Windows first.
- For performance and publishing guidance (e.g., ReadyToRun, runtime identifiers), include explicit Linux examples and clarify any differences or limitations.
- In debugging and development sections, provide Linux-specific instructions and troubleshooting steps, not just Windows/Visual Studio workflows.
- When referencing tools (e.g., Azure CLI, PowerShell), ensure Linux and cross-platform tools are given equal or greater prominence compared to Windows-only tools.
- Review all code and command snippets to ensure parity between Windows and Linux, including file paths, environment variables, and shell syntax.
Create pull request