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
⚠️
missing_linux_example
Summary:
The documentation provides both Linux and Windows instructions for most tasks, but there are several areas where Windows is prioritized or receives more detailed coverage. Windows-specific tools and patterns (such as Kudu, Advanced Tools, and web.config) are referenced, sometimes without Linux equivalents or with less detail for Linux. Some sections, like Java Flight Recorder usage, provide more step-by-step guidance for Windows (e.g., using Kudu Process Explorer), while Linux instructions assume more familiarity. In a few places, Windows is mentioned first or exclusively, and some advanced configuration notes are only present for Windows.
Recommendations:
- Ensure that for every Windows-specific tool or workflow (e.g., Kudu, Advanced Tools, web.config), an equivalent Linux approach is described, or explicitly state if not applicable.
- Balance the order of presentation: alternate between Linux-first and Windows-first, or present both platforms in parallel.
- Provide equally detailed, step-by-step instructions for Linux as are given for Windows, especially for advanced diagnostics and configuration (e.g., finding Java process IDs, using SSH, log file locations).
- Where Windows-specific notes are given (such as not needing web.config for Tomcat), add corresponding Linux notes or clarify if not needed.
- Audit for any missing Linux examples, especially in sections where only Windows tools or paths are referenced, and add Linux equivalents.
- Review terminology to avoid implying Windows is the default or primary platform (e.g., avoid phrases like 'on Windows you can...' without a Linux counterpart).
Create pull request