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
⚠️
minor_missing_linux_example
Summary:
The documentation uses platform pivots to provide both Windows and Linux instructions, but Windows examples and terminology are generally presented first. Some instructions and directory structures are more detailed for Windows, and certain tools and patterns (such as 'Advanced Tools' in the Azure portal) are described in a way that aligns more closely with Windows environments. There is also a minor inconsistency in the runtime versions between Windows and Linux examples, and some steps (like directory navigation) are more explicit for Windows.
Recommendations:
- Alternate the order of platform pivots so that Linux instructions are sometimes presented first, or present both platforms side-by-side where possible.
- Ensure parity in detail and clarity between Windows and Linux instructions, including directory structures and command examples.
- Standardize runtime versions and naming conventions across both platforms to avoid confusion (e.g., use 'NODE:20LTS' vs 'NODE:20-lts' consistently).
- When referencing Azure portal tools or features (like 'Advanced Tools'), clarify if they are available and behave identically on both Windows and Linux App Service plans.
- Review all examples and troubleshooting steps to ensure Linux users are not left with less information or less explicit guidance.
Create pull request