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
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. Windows-specific tools and configuration steps (such as Visual Studio, PowerShell, and Windows runtime identifiers) are often mentioned first or in more detail than their Linux equivalents. Some CLI examples and deployment instructions are Windows-centric, and Linux alternatives are sometimes only briefly referenced or relegated to tabs. There are also places where Linux-specific examples or troubleshooting steps are missing or less emphasized, especially around deployment, debugging, and performance optimization.
Recommendations:
- Ensure that all CLI and deployment examples are provided for both Windows and Linux, with equal detail and prominence.
- When listing tools or configuration steps, present cross-platform options (e.g., Azure CLI, Visual Studio Code) before or alongside Windows-only tools (e.g., Visual Studio, PowerShell).
- Include Linux-specific troubleshooting and debugging instructions, especially for scenarios like remote debugging and ReadyToRun publishing.
- Where platform-specific tabs are used, ensure both Windows and Linux tabs are present and equally detailed.
- Explicitly mention any differences in behavior or requirements between Windows and Linux throughout the document, not just in isolated sections.
- Provide parity in example commands (e.g., az CLI, dotnet publish) and clarify any OS-specific flags or considerations.
- Review all references to project file settings (like RuntimeIdentifier) and ensure Linux values are always included alongside Windows values.
Create pull request