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 a mild Windows bias. Windows-specific paths (e.g., D:\home\site\wwwroot) are mentioned first, and the Kudu UI (which is not supported on Linux) is described in detail before alternatives for Linux are suggested. The use of 'Advanced Tools' in the Azure portal (Kudu) is a Windows-centric workflow, and Linux-specific instructions or parity for certain features (like the Kudu UI) are absent. Some examples and notes reference Windows paths or behaviors before Linux equivalents, and there is limited explicit guidance for Linux users in these cases.
Recommendations:
- When mentioning default paths, list Linux and Windows paths together or alternate the order to avoid always putting Windows first.
- Clearly indicate feature parity or lack thereof for both Windows and Linux at the start of each section, not only in notes after the fact.
- Provide Linux-specific alternatives or workflows (such as using FTP, Azure CLI, or Kudu API) in parallel with Windows/Kudu UI instructions, rather than as afterthoughts.
- Where UI or tool support differs (e.g., Kudu UI not available on Linux), offer a step-by-step Linux-friendly alternative with equal prominence.
- Use neutral language and examples (e.g., use /home/site/wwwroot as the canonical path in code snippets, or show both Windows and Linux paths where relevant).
Create pull request