Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
windows_tools
Summary
The documentation page exhibits a strong Windows bias. All code examples use PowerShell and reference Windows-specific paths and services. The 'Platform' parameter is always set to 'Windows' in examples, and there are no Linux-specific examples or references to Linux services, file paths, or shell commands. Windows tools and patterns (e.g., PowerShell cmdlets, Windows service auditing) are used exclusively, with no parity for Linux equivalents.
Recommendations
- Add Linux-specific examples for creating and publishing machine configuration policies, including setting 'Platform' to 'Linux'.
- Provide sample code using Linux file paths (e.g., '/home/user/package.zip') and Linux services (e.g., 'sshd', 'cron') in DSC resource definitions.
- Include instructions and code snippets for using Bash or Azure CLI where appropriate, not just PowerShell.
- Clarify any differences in managed identity usage or agent versions between Windows and Linux, and provide Linux-focused guidance.
- Ensure that examples and explanations alternate or equally represent both Windows and Linux scenarios, rather than defaulting to Windows.
Create Pull Request