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 paths (e.g., C:\Local\Path\To\Package). The 'Platform' parameter is always set to 'Windows' in examples, and Windows services are referenced in parameter examples. There are no Linux-specific examples, commands, or references to Linux service management, nor are Linux file paths or tools shown. The documentation assumes the use of Windows tools and patterns throughout, with Linux only mentioned in passing (e.g., version requirements).
Recommendations
- Include Linux-specific examples for all major steps, such as using Bash or Azure CLI instead of PowerShell, and referencing Linux file paths (e.g., /home/user/package.zip).
- Demonstrate policy definitions targeting Linux, with 'Platform' set to 'Linux', and use Linux service names and management patterns in parameter examples.
- Provide guidance for setting up the authoring environment on Linux, including installation of required modules and dependencies.
- Reference Linux equivalents for Windows-specific cmdlets and tools, or clarify cross-platform compatibility where appropriate.
- Ensure that both Windows and Linux scenarios are covered equally in all example sections, including managed identity usage and storage access patterns.
Create Pull Request