Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation exhibits a moderate Windows bias. Troubleshooting steps and examples often reference Windows tools (PowerShell, .NET EventSource, Application Insights, Sysinternals' psping) and provide Windows commands before Linux equivalents. Some diagnostic and logging guidance is .NET-centric, with limited mention of cross-platform alternatives. Linux/macOS users are given fewer examples, and Windows-specific tools are recommended without clear Linux substitutes.
Recommendations
- Provide Linux/macOS equivalents for all troubleshooting commands and tools (e.g., show 'telnet' or 'nc' before or alongside 'tnc', suggest 'ss', 'netcat', or 'tcping' for port checks).
- Include cross-platform logging and tracing instructions (e.g., OpenTelemetry setup for Java, Python, Node.js, not just .NET).
- Mention and link to Linux/macOS-friendly diagnostic tools (e.g., Wireshark, tcpdump, strace) alongside Windows tools.
- Ensure code samples and troubleshooting steps are not .NET/.NET Core exclusive; add examples for Java, Python, and other SDKs.
- Avoid recommending Windows-only utilities (like psping) without suggesting cross-platform alternatives.
- When referencing PowerShell, provide Bash/zsh equivalents for Linux/macOS users.
- Balance the order of examples so Linux/macOS instructions are not always secondary.
Create Pull Request