Detected Bias Types
🔧
Windows Tools
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation is heavily Windows-centric, with all examples, tooling, and setup instructions assuming a Windows environment. All scripts, commands, and sample setups use Windows batch files (.cmd), PowerShell, and Windows-specific utilities (msiexec.exe, cmdkey, odbcconf.exe, etc.). There are no Linux or macOS equivalents, nor any mention of how to adapt the process for non-Windows platforms. The Azure-SSIS IR itself is a Windows-based runtime, but the documentation does not clarify this upfront or offer guidance for users coming from Linux/macOS backgrounds.
Recommendations
- Explicitly state early in the documentation that Azure-SSIS IR is a Windows-only runtime, and that all customization is performed in a Windows environment.
- Add a section for Linux/macOS users explaining the limitations and alternatives, such as using Azure Data Factory Mapping Data Flows or other cross-platform ETL tools.
- Where possible, provide guidance on how Linux/macOS users can prepare setup scripts (e.g., using PowerShell Core on macOS/Linux, or preparing files on Windows VMs).
- Clarify that tools like Azure Storage Explorer and Azure PowerShell are available cross-platform, but that custom setup scripts must be Windows-compatible.
- Add a FAQ or troubleshooting section for non-Windows users, outlining what is and is not possible.