Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Summary
The documentation page exhibits mild Windows bias, primarily in the Azure PowerShell section. PowerShell is a Windows-centric tool, and the instructions for installing Azure PowerShell specifically reference Windows and PowerShellGet, with no mention of Linux/macOS alternatives. The sample code for PowerShell uses Windows-style file paths (e.g., C:\ADFv2QuickStartPSH\), and the PowerShell section precedes the Azure CLI section, which is more cross-platform. However, the page does provide Azure CLI, Python, and .NET examples, which are cross-platform, and does not omit Linux/macOS-compatible instructions for the core task.
Recommendations
- In the Azure PowerShell prerequisites, clarify that Azure PowerShell can be installed on Linux/macOS and provide a link to cross-platform installation instructions.
- Use neutral file paths in examples (e.g., ./ADFv2QuickStartPSH/MyTrigger.json) or provide both Windows and Linux/macOS path variants.
- Consider presenting Azure CLI instructions before PowerShell, as CLI is more universally available across platforms.
- Explicitly state that all SDK and CLI examples work on Linux/macOS, and link to relevant installation guides.
- Add a note that PowerShell Core is available on Linux/macOS, and provide installation guidance.