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 Tomcat data sources, but the Windows section is notably more detailed and uses Windows-specific tools and scripts (PowerShell, .cmd files, Windows environment variables). The Windows instructions are longer, more step-by-step, and rely on Windows-native patterns, while the Linux section is more concise and expects familiarity with shell scripting and Linux tools. The order of presentation sometimes places Windows instructions before or more prominently than Linux equivalents, and the Windows approach is described as the 'simplest way.'
Recommendations:
- Ensure Linux and Windows instructions are equally detailed and parallel in structure, with matching step-by-step guides and troubleshooting notes.
- Avoid describing the Windows approach as 'simplest' unless the same is said for Linux; strive for neutral language.
- Where possible, provide cross-platform (e.g., Bash and PowerShell) script examples side-by-side, or reference equivalent tooling for Linux (e.g., Bash scripts instead of only PowerShell).
- List Linux and Windows instructions in the same order in each section, or present them in tabs to avoid implicit prioritization.
- Highlight any differences in capabilities or limitations between platforms explicitly, rather than assuming Windows as the default.
- If using environment variables or file paths, always show both Windows and Linux formats together.
Create pull request