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
Summary:
The documentation provides both Linux and Windows instructions for configuring server-level data sources in Tomcat, but the Windows section is notably more detailed, with step-by-step PowerShell scripts and explicit use of Windows-specific tools and paths. The Windows instructions are longer, more prescriptive, and introduce Windows tools (PowerShell, cmd, Windows paths) before or more prominently than their Linux equivalents. The Linux section, while present, is less detailed and assumes more prior knowledge. There is also a reliance on PowerShell and Windows environment variables in the Windows section, which is not matched by equivalent Linux scripting guidance.
Recommendations:
- Ensure Linux and Windows sections have parity in detail and step-by-step guidance. For example, provide a full sample Linux shell script (not just a snippet) for the startup process, similar to the PowerShell script for Windows.
- Introduce Linux instructions before or alongside Windows instructions, rather than after, to avoid a 'Windows-first' impression.
- Where Windows-specific tools (like PowerShell) are used, provide equivalent Linux shell (bash/sh) scripts and explain their usage in equal detail.
- Use neutral language and structure (e.g., present both OS tabs together, or default to Linux if usage data supports it).
- Explicitly mention any differences in capabilities or limitations between Linux and Windows App Service environments.
- Where possible, use cross-platform tools or commands (e.g., Azure CLI) in examples, and clarify any OS-specific steps.
Create pull request