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 demonstrates a clear Windows bias. Windows tools and patterns (such as PowerShell remoting, WMI, and WinRM) are mentioned first and in detail, while Linux equivalents are often only briefly referenced or described as secondary. Many requirements and examples are specific to Windows (e.g., detailed PowerShell and SQL Server authentication scripts for Windows, explicit mention of Windows ports and permissions), and Linux support is sometimes missing or not supported (e.g., SQL Server discovery on Linux is not supported, ASP.NET web app discovery is Windows-only). Where Linux is supported, the documentation provides less detail, fewer examples, and less guidance compared to Windows.
Recommendations:
- Provide Linux-first or at least Linux-equal examples and explanations alongside Windows ones, especially for setup, permissions, and troubleshooting.
- Include detailed Linux command-line examples (e.g., for configuring SSH, required permissions, and package installation) similar to the PowerShell examples provided for Windows.
- Where features are not supported on Linux (e.g., SQL Server discovery), clearly state roadmap or alternatives, and provide links to relevant Linux migration/discovery documentation.
- Balance the order of presentation so that Linux and Windows requirements are described in parallel, not always with Windows first.
- Expand on Linux-specific troubleshooting, error messages, and best practices, matching the depth provided for Windows.
- Where possible, provide parity in supported features for Linux and document any gaps transparently.
Create pull request