Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a strong Windows bias. All code examples use PowerShell and reference Windows-specific cmdlets and paths. The 'Platform' parameter is always set to 'Windows' in examples, and file paths use Windows conventions (e.g., C:\Local\Path\To\Package). There are no Linux/Bash/CLI examples, and Linux-specific considerations are only mentioned in passing (e.g., minimum agent version). Windows tools and patterns are presented exclusively, with no parity for Linux users.
Recommendations
- Provide equivalent examples using Bash or Azure CLI for Linux users, especially for tasks like setting variables, uploading packages, and creating policies.
- Include at least one example where the 'Platform' parameter is set to 'Linux', and use Linux file path conventions (e.g., /home/user/package.zip) in those examples.
- Mention Linux prerequisites and environment setup steps alongside Windows/PowerShell instructions.
- Reference Linux tools (e.g., az CLI, bash scripting) and show how to accomplish the same tasks without PowerShell.
- Clarify which steps are OS-agnostic and which require OS-specific commands, ideally grouping examples by platform.
Create Pull Request