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 generally provides both Linux and Windows instructions, 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 FTPS) are mentioned prominently, sometimes before Linux equivalents. Some sections (e.g., Java Flight Recorder, logging, and process management) provide more step-by-step detail for Windows, including GUI navigation, while Linux instructions are more command-line focused or less detailed. There are also references to Windows-specific behaviors (like web.config) and tools without always providing Linux alternatives or parity in explanation.
Recommendations:
- Ensure that Linux and Windows instructions are presented with equal prominence and detail, ideally side-by-side or with Linux-first ordering where appropriate.
- Where Windows-specific tools (e.g., Kudu, FTPS, Advanced Tools) are referenced, provide equivalent Linux-native approaches or clarify if not applicable.
- Expand Linux examples to match the step-by-step detail given for Windows, especially for tasks like process management, log retrieval, and profiler usage.
- Avoid referencing Windows-specific configuration files (like web.config) without noting their irrelevance on Linux, and provide Linux-specific configuration guidance where applicable.
- Review all sections for parity in troubleshooting, deployment, and configuration guidance, ensuring Linux users are not left with less actionable information.
- Where possible, use cross-platform CLI tools (e.g., Azure CLI, SSH) as the primary example, and only supplement with OS-specific tools as needed.
Create pull request