Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page displays a Windows bias in several ways: PowerShell is presented before Azure CLI, and the PowerShell section explicitly references installation on Windows and uses Windows-style file paths (e.g., C:\ADFv2QuickStartPSH\). There are no Linux-specific instructions or examples for PowerShell or CLI usage (e.g., bash, Linux file paths, or shell environments). The prerequisites and sample code for PowerShell are Windows-centric, and there is no mention of Linux equivalents or cross-platform considerations in those sections.
Recommendations
- Add explicit instructions for installing and using Azure PowerShell on Linux and macOS, including links to cross-platform installation guides.
- Provide sample PowerShell commands using Linux/macOS file paths (e.g., /home/user/ADFv2QuickStartPSH/) alongside Windows examples.
- In the Azure CLI section, clarify that the CLI is cross-platform and show examples of usage in bash/zsh environments, including Linux/macOS file system paths.
- Reorder sections so that cross-platform tools (Azure CLI, SDKs) are presented before Windows-specific tools (PowerShell), or present them in parallel.
- Add notes or callouts highlighting platform differences and considerations for Linux/macOS users, such as file path formats and shell environments.
- Ensure that screenshots and UI references are not Windows-specific unless necessary, and provide alternatives or clarifications for other platforms.
Create Pull Request