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 demonstrates a 'windows_first' bias by presenting Windows-specific instructions and examples before Linux equivalents in several sections. It also references Windows-specific tools and directory structures (e.g., 'js-e2e-web-app-easy-auth-app-to-app/frontend' vs 'frontend'), and omits or simplifies Linux-specific guidance in some cases. The Linux instructions are present but sometimes less detailed or appear as an afterthought. There is also a lack of parity in runtime versions and directory navigation between Windows and Linux examples.
Recommendations:
- Present Windows and Linux instructions in parallel or in a unified table, rather than always listing Windows first.
- Ensure that Linux examples are as detailed and accurate as Windows examples, including directory structure and runtime versions.
- Avoid Windows-centric terminology or tools unless absolutely necessary; provide Linux equivalents where possible.
- Use neutral language and structure (e.g., 'cd frontend' for both platforms if possible) to reduce perceived bias.
- Explicitly call out any platform-specific differences and explain why they exist.
- Review and update runtime versions for parity (e.g., use the same Node.js version for both Windows and Linux examples).
Create pull request