Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a strong Windows bias, especially in the troubleshooting sections for workload orchestration. Most command-line examples use PowerShell syntax and Windows-specific patterns (e.g., variable assignment, piping, file encoding), with no equivalent Bash/Linux examples provided. Windows tools and conventions (such as Out-File, ConvertTo-Json, and PowerShell variable assignment) are used exclusively or explained first, making it difficult for Linux/macOS users to follow. Only the 'service groups' section provides both Bash and PowerShell tabs; all other sections are Windows-centric.
Recommendations
- Provide Bash/Linux equivalents for all PowerShell commands, especially for az CLI, kubectl, docker, and file manipulation steps.
- Avoid using Windows-specific tools (e.g., Out-File, ConvertTo-Json) without offering cross-platform alternatives (e.g., jq, echo, cat, > operator).
- Document file encoding steps for Linux/macOS (e.g., using iconv or native editors).
- Ensure variable assignment and scripting examples use syntax compatible with Bash and PowerShell, or clearly separate them.
- Present Bash/Linux examples before or alongside PowerShell to reduce perceived Windows primacy.
Create Pull Request