Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation is heavily biased toward Windows and PowerShell. All code examples use PowerShell, with no equivalent Bash or Linux shell examples. The 'Platform' parameter is always set to 'Windows' in examples, and file paths use Windows conventions (e.g., C:\Local\Path\To\Package). Windows-specific tools and cmdlets are referenced exclusively, and Linux equivalents or cross-platform alternatives are not demonstrated. There is little to no guidance for Linux users, despite the product supporting Linux.
Recommendations
- Provide equivalent examples using Bash or Azure CLI for Linux environments.
- Include at least one example with the 'Platform' parameter set to 'Linux', and use Linux-style file paths (e.g., /home/user/package.zip).
- Mention and demonstrate how to install required modules and set up the authoring environment on Linux, not just Windows.
- Clarify any differences or additional steps needed for Linux-based machines, especially regarding managed identities and agent versions.
- Where PowerShell is required, explicitly note cross-platform compatibility and provide instructions for PowerShell Core on Linux.
- Balance the order of presentation so that Linux and Windows are treated equally, or alternate which platform is shown first.
Create Pull Request