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 ways: Windows paths and conventions are often given as the primary or only example (e.g., 'D:\home'), Windows-specific tools and settings (such as MSDeploy, Web Deploy, and references to w3wp.exe) are described in detail, and Windows-specific environment variables and behaviors are explained more thoroughly or before their Linux equivalents. In some cases, Linux options are mentioned as exceptions or afterthoughts, and Linux-specific examples or explanations are missing or less detailed.
Recommendations:
- For every environment variable or feature, provide both Windows and Linux examples side by side, especially for file paths, default values, and behaviors.
- Avoid presenting Windows as the default or primary platform; instead, use neutral language or alternate the order of Windows and Linux references.
- Include Linux-native tools and deployment patterns (e.g., rsync, scp, tar) where Windows tools like MSDeploy or Web Deploy are mentioned.
- Ensure that Linux-specific environment variables, behaviors, and troubleshooting steps are as detailed and prominent as their Windows counterparts.
- Where platform-specific behaviors exist, clearly indicate them in a comparative table or section, rather than embedding Linux as an exception in Windows-focused text.
- Add Linux/POSIX shell command examples (e.g., export, echo $VAR) where PowerShell or Windows command prompt examples are given.
- Review and expand documentation for Linux container scenarios, ensuring parity in depth and clarity with Windows container documentation.
Create pull request