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
⚠️
windows_tools
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows bias in several ways: Windows-specific tools and patterns (such as PowerShell remoting, WMI, and WinRM) are mentioned and described in detail, often before or instead of Linux equivalents. Windows permissions and account setup are explained with more granularity, and PowerShell is referenced as the primary method for many operations. In contrast, Linux instructions are present but less detailed, and some features (such as SQL Server discovery and ASP.NET web app discovery) are not supported on Linux at all. Example scripts and troubleshooting steps are provided for Windows but are missing or less comprehensive for Linux.
Recommendations:
- Provide Linux-first or parallel Linux examples and instructions wherever Windows instructions are given, especially for permissions, account setup, and troubleshooting.
- Include Linux-specific troubleshooting guidance and example scripts for common setup and permission issues, similar to the detailed steps provided for Windows.
- Where features are not supported on Linux (e.g., SQL Server discovery, ASP.NET web app discovery), clearly state the roadmap or alternatives for Linux users, and consider parity where technically feasible.
- Balance the order of presentation so that Linux and Windows instructions are given equal prominence, rather than listing Windows first by default.
- Where PowerShell scripts are provided for Windows, offer Bash or shell script equivalents for Linux setup and management tasks.
- Ensure that all tables and matrices include Linux-specific details and not just Windows-centric requirements.
Create pull request