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 exhibits a Windows-first bias in several ways: Windows-specific paths and tools are often mentioned before or instead of Linux equivalents (e.g., 'D:\home' before '/home'), and many environment variables and examples reference Windows concepts (such as IIS, Web Deploy, MSDeploy, and .NET/ASP.NET specifics) without always providing Linux or cross-platform alternatives. Some sections, especially around build automation and deployment, provide detailed Windows/Kudu/MSDeploy guidance but only briefly mention Oryx/Linux or relegate Linux info to separate tabs. Several environment variables are described as 'Windows only' or default to Windows behaviors, and some features/tools (like Web Deploy) are described in detail for Windows but not for Linux. There are also cases where Linux-specific examples or usage patterns are missing or less detailed.
Recommendations:
- For every Windows-specific path or tool mentioned (e.g., 'D:\home', IIS, MSDeploy), provide the Linux equivalent (e.g., '/home', Nginx/Apache, Oryx) side-by-side or in parallel.
- Ensure that all environment variable descriptions specify both Windows and Linux behaviors, defaults, and paths where applicable.
- Where build and deployment automation is discussed, give equal prominence and detail to Oryx/Linux workflows as to Kudu/Windows workflows, rather than relegating Linux to a secondary tab.
- Add Linux-specific examples and usage notes in all relevant sections, especially where only Windows or PowerShell examples are currently given.
- Avoid Windows-centric language such as 'applicationHost.config', 'w3wp.exe', or '%HOME%' without also providing Linux context (e.g., 'web.config', 'dotnet', '/home', '$HOME').
- Where features are not available or behave differently on Linux, clearly state this and provide Linux alternatives or workarounds if possible.
- Review all tables and examples for parity, ensuring that Linux users can find relevant, actionable information without needing to infer or search elsewhere.
Create pull request