Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation is heavily focused on PowerShell and Windows-specific examples, with all code samples using PowerShell syntax and Windows file paths. The 'Platform' parameter is always set to 'Windows' in examples, and there are no equivalent Linux/macOS shell or file path examples. Windows tools and patterns (e.g., PowerShell cmdlets, C:\ paths) are used exclusively, and Linux is only mentioned in passing (e.g., required agent version), without actionable guidance or parity in examples.
Recommendations
- Provide Linux/macOS-specific examples using Bash or Azure CLI, especially for steps like setting variables, uploading packages, and creating policy definitions.
- Show examples where the 'Platform' parameter is set to 'Linux', with relevant Linux file paths (e.g., /home/user/package.zip) and context.
- Include guidance for installing required modules and setting up the authoring environment on Linux/macOS, not just Windows.
- Where PowerShell is required, clarify cross-platform usage and provide instructions for installing PowerShell on Linux/macOS.
- Add notes or sections highlighting differences or additional steps for Linux/macOS users, including troubleshooting tips.
Create Pull Request