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 page demonstrates Windows bias by referencing Windows directory paths (e.g., D:\home\site\wwwroot, D:\home\data\SitePackages) before mentioning Linux equivalents, and by using Windows-style path separators in examples. There is a lack of explicit Linux-specific instructions or examples, and the documentation assumes familiarity with Windows conventions and tools, such as FTP and directory creation in Windows paths. Linux paths are mentioned only parenthetically and not in examples or step-by-step instructions.
Recommendations:
- Provide Linux-specific examples alongside Windows ones, including explicit Linux directory paths (e.g., /home/site/wwwroot, /home/data/SitePackages) in commands and instructions.
- Use platform-agnostic language and path separators, or clearly distinguish between Windows and Linux instructions.
- Include troubleshooting and deployment steps that address Linux-specific scenarios, such as permissions and file system differences.
- Add examples using Linux-native tools (e.g., SCP, SFTP, rsync) for uploading ZIP packages, in addition to FTP.
- Ensure parity in documentation for both Windows and Linux App Service environments, including screenshots or terminal outputs where appropriate.
Create pull request