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 Windows-first bias in several areas: Windows paths and conventions are often mentioned before Linux equivalents, Windows-specific tools (such as MSDeploy, Web Deploy, and Kudu for Windows) are described in detail, and some settings are explained only in a Windows context or with Windows-centric examples. There are also several environment variables and features that are described primarily or exclusively for Windows, with Linux equivalents either missing, less detailed, or mentioned secondarily. In some sections, Linux-specific behaviors are described as exceptions or afterthoughts. There is a lack of parity in example commands, paths, and tool references for Linux users.
Recommendations:
- For every environment variable or feature that behaves differently on Windows and Linux, provide both Windows and Linux examples side by side, including file paths, default values, and configuration nuances.
- When referencing tools or deployment methods (e.g., MSDeploy, Web Deploy, Kudu), ensure that Linux equivalents (such as Oryx, ZIP deploy, or other Linux-native tools) are described with equal detail and prominence.
- Avoid using Windows paths (e.g., D:\home) as the sole example; always include the Linux equivalent (/home) in the same context.
- Where features are Windows-only, explicitly state the lack of Linux support and, where possible, suggest Linux alternatives or workarounds.
- Reorganize sections so that Linux and Windows information is presented in parallel, rather than Windows-first with Linux as an addendum.
- Add Linux/POSIX shell command examples (where relevant) alongside any PowerShell or Windows CMD examples.
- Audit the documentation for any settings or behaviors that are only described for Windows and ensure Linux users have clear, actionable guidance.
Create pull request