Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page exhibits several signs of Windows bias. The Azure PowerShell section is prominent and includes explicit instructions for installing Azure PowerShell on Windows with PowerShellGet. The sample code for PowerShell assumes a Windows file path (C:\ADFv2QuickStartPSH\), and there are no equivalent instructions or examples for using PowerShell on Linux or macOS. The CLI section is present, but the PowerShell instructions are listed first and in greater detail. There are no examples showing Linux-specific tools, shell environments, or file path conventions, nor any mention of cross-platform considerations for PowerShell or CLI usage.
Recommendations
- Add explicit instructions and examples for running Azure PowerShell on Linux and macOS, including installation steps and file path conventions.
- Include sample file paths using Linux/macOS conventions (e.g., /home/user/ADFv2QuickStartPSH/MyTrigger.json) alongside Windows examples.
- Clarify that Azure PowerShell and Azure CLI are cross-platform, and provide guidance for users on non-Windows systems.
- Ensure that CLI and PowerShell examples are given equal prominence, and consider listing CLI examples first to avoid implicit Windows-first bias.
- Mention alternative editors and environments (e.g., VS Code, nano, vim) for creating JSON files on Linux/macOS.
- Add troubleshooting notes or tips for common issues encountered on Linux/macOS (e.g., file permissions, path separators).
Create Pull Request