Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation is heavily biased towards Windows and PowerShell. All command-line examples use PowerShell, and the installation and usage of the self-hosted integration runtime is described exclusively for Windows. There are no instructions or examples for Linux or macOS users, nor any mention of cross-platform alternatives for the integration runtime or command-line tools. Windows-specific tools and patterns (e.g., SSMS, C:\ paths, PowerShell cmdlets) are used throughout, making it difficult for non-Windows users to follow the tutorial.
Recommendations
- Provide equivalent instructions and examples for Linux/macOS users, including using Azure CLI or REST API for Data Factory operations.
- Clarify whether the self-hosted integration runtime can be installed on Linux/macOS, and provide installation steps if supported.
- Offer alternatives to Windows-only tools (e.g., suggest Azure Data Studio instead of SSMS, use platform-agnostic folder paths).
- Explicitly state platform requirements and limitations at the beginning of the tutorial.
- Where PowerShell is used, show how to perform the same steps with Azure CLI or other cross-platform tools.
Create Pull Request