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
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several ways: Windows agents and tools (such as Web Deploy) are featured prominently, with examples and troubleshooting focused on Windows scenarios. The 'Deploy using Web Deploy' section only provides a Windows-based example, and troubleshooting for Web Deploy is Windows-specific. While there is some mention of Linux (e.g., 'Azure Web App on Linux'), Linux-specific deployment methods and troubleshooting are not covered in equal detail. There are no Linux shell or cross-platform script examples, and Windows agent images are often referenced first or exclusively in key sections.
Recommendations:
- Provide equivalent Linux-based deployment examples, especially for scenarios like 'Deploy using Web Deploy' where only Windows is currently shown.
- Include troubleshooting guidance for Linux agents, not just Windows (e.g., what to do if a deployment fails on Linux).
- When referencing agent images, list both Windows and Linux options equally, or alternate their order.
- Offer cross-platform script examples (e.g., Bash as well as PowerShell) where scripts are shown.
- Clarify which features or tasks are Windows-only and suggest Linux alternatives where possible.
- Expand the FAQ and error messages to include Linux agent scenarios and solutions.
Create pull request