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
⚠️
windows_tools
⚠️
powershell_heavy
Summary:
The documentation demonstrates a Windows bias in several ways: Windows-specific deployment methods (Web Deploy) are described in detail, with explicit instructions to use Windows agents and references to IIS and web.config. Linux deployment is mentioned as an option, but Linux-specific examples, troubleshooting, or tools are lacking. The primary detailed example for deploying with Web Deploy is only for Windows, and the FAQ reinforces this by stating Web Deploy is only supported on Windows agents. There are no Linux shell or command-line examples, and Windows patterns (such as web.config and IIS) are referenced without Linux equivalents.
Recommendations:
- Provide equivalent Linux deployment examples, such as using zip deploy or FTP/SFTP, and include Linux-specific troubleshooting steps.
- When mentioning deployment methods like Web Deploy, also highlight and provide examples for Linux-friendly alternatives (e.g., Kudu REST API, zip deploy, or container-based deployments).
- Avoid referencing Windows tools (e.g., IIS, web.config) without mentioning Linux equivalents (e.g., Nginx, Gunicorn, app.yaml for Python, etc.) where appropriate.
- Ensure that all YAML and Classic pipeline examples show both Windows and Linux agent configurations, and clarify any differences in steps or requirements.
- Include at least one end-to-end example for a Linux-based stack (e.g., Node.js or Python on Linux App Service) with Linux agent, including build, publish, and deploy steps.
Create pull request