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 some Windows bias, particularly in deployment, configuration, and debugging sections. Windows-specific instructions and tools (such as Visual Studio and PowerShell) are often mentioned before or more prominently than their Linux equivalents. Some examples and CLI commands are provided only for Windows or are Windows-first, with Linux alternatives appearing later or not at all. There are also places where Linux-specific guidance is less detailed or omitted.
Recommendations:
- Ensure that all CLI and deployment instructions are presented for both Windows and Linux equally, ideally side-by-side or with clear tabs for each OS.
- When listing tools or workflows (e.g., Visual Studio, Visual Studio Code, Azure CLI, Azure PowerShell), avoid always listing Windows tools first; rotate or group by platform.
- For every PowerShell or Windows-specific example, provide an equivalent Bash/Linux example.
- In debugging and performance optimization sections, explicitly describe Linux workflows and tools, not just Windows (e.g., attach to process, checking architecture, ReadyToRun publishing).
- Where possible, use cross-platform tools (like Azure CLI) as the primary example, and only supplement with platform-specific tools as needed.
- In tables and lists, avoid defaulting to Windows as the primary or only exampleβensure Linux is equally represented.
- Review all code snippets and ensure any file paths, commands, or environment variables are cross-platform or have both Windows and Linux variants.
Create pull request