Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a Windows bias in several ways. Windows and PowerShell tools and patterns are mentioned and used exclusively or before Linux equivalents. Examples and instructions are centered around Windows tooling (WAD, PowerShell, Visual Studio), with little to no mention of Linux-specific diagnostics (LAD) or command-line examples. The page references Windows-centric logging mechanisms (ETW), and links to Windows-focused templates and guides. Linux alternatives are only referenced in a selector at the top, with no parity in examples or walkthroughs within the main content.
Recommendations
- Include Linux-specific examples and instructions alongside Windows ones, especially for diagnostics extension deployment, configuration, and log collection.
- Provide equivalent Linux command-line examples (e.g., Azure CLI, bash scripts) instead of only PowerShell.
- Reference Linux diagnostics tools (LAD) and logging mechanisms (such as syslog, journald) where ETW and Windows EventSource are discussed.
- Ensure links to Linux documentation are as prominent and detailed as Windows ones, and avoid referencing only Windows templates or guides.
- Add troubleshooting and configuration guidance for Linux clusters, including performance counter collection and Application Insights integration.
- Where Visual Studio is mentioned, provide alternatives for Linux development environments (e.g., VS Code, command-line tools).
Create Pull Request