Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias in its examples and tooling references. The only command-line example for running a pipeline is given in Azure PowerShell, with no equivalent Bash, Azure CLI, or Linux-native example. The PowerShell example is presented before the Python SDK and REST API, and there is no mention of cross-platform tools such as Azure CLI. The documentation assumes familiarity with PowerShell and Windows tooling, omitting Linux or macOS command-line workflows.
Recommendations
- Add Azure CLI examples for running pipelines, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Provide Bash shell examples for REST API calls (e.g., using curl) to demonstrate manual pipeline execution on Linux.
- Ensure that references to tooling (such as PowerShell) are accompanied by equivalent Linux/macOS instructions or alternatives.
- Reorder examples so that cross-platform tools (Azure CLI, REST API, Python SDK) are presented before or alongside Windows-specific tools like PowerShell.
- Explicitly state that all SDKs and APIs are available on Linux, and provide links or notes for Linux/macOS users.
Create Pull Request