Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a bias towards Windows environments. The Azure PowerShell section is presented before the Azure CLI, and PowerShell is described with explicit Windows installation instructions and Windows-style file paths (e.g., C:\ADFv2QuickStartPSH\). There are no Linux-specific instructions, examples, or notes for PowerShell or CLI usage, nor any mention of Linux shell equivalents or cross-platform considerations. The documentation assumes a Windows environment for scripting and tooling, and omits guidance for Linux users.
Recommendations
- Add explicit Linux instructions for Azure PowerShell installation and usage, including Linux-compatible file paths and shell commands.
- Include cross-platform notes for both PowerShell and CLI sections, clarifying usage on Linux, macOS, and Windows.
- Present Azure CLI examples before or alongside PowerShell, as CLI is natively cross-platform.
- Provide sample commands using Linux shell syntax (e.g., bash), and clarify any differences in file path handling.
- Mention that JSON files and scripts can be created and used on Linux/macOS, not just Windows.
- Add troubleshooting notes for common Linux issues (e.g., file permissions, path separators) when working with triggers.
- Ensure screenshots and UI references do not assume a Windows look-and-feel exclusively.
Create Pull Request