Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias in several ways. The Azure PowerShell section is presented before the Azure CLI section, and PowerShell is described with explicit instructions for installation on Windows. File path examples use Windows-style paths (e.g., C:\ADFv2QuickStartPSH\), and there is no mention of Linux or macOS alternatives for PowerShell installation or file paths. The documentation does not provide Linux-specific instructions or examples, nor does it discuss cross-platform considerations for command-line usage or file system paths. The CLI section is more platform-neutral, but the overall ordering and example choices favor Windows users.
Recommendations
- Add explicit instructions and examples for Linux and macOS users, including file path formats and PowerShell installation steps for those platforms.
- Present Azure CLI examples before or alongside PowerShell examples, as CLI is more platform-agnostic.
- Use platform-neutral file paths in code samples, or provide both Windows and Linux/macOS variants (e.g., C:\path vs. /home/user/path).
- Mention cross-platform compatibility for tools and commands, and link to relevant installation guides for each OS.
- Clarify that Azure PowerShell and CLI are available on multiple platforms, and provide guidance for non-Windows environments.
Create Pull Request