Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits a moderate Windows bias. Troubleshooting steps and examples for common issues are predominantly described for Windows environments, often using Windows-specific tools (PowerShell, registry edits, Windows event logs) and file paths. Windows scenarios and resolutions are frequently presented before Linux equivalents, and some workarounds (such as editing Orchestrator.Sandbox.exe.config) are only described for Windows. Linux troubleshooting is covered in a separate section, but with less detail and fewer example scripts. Some issues (e.g., updating Az modules, event log checks) lack Linux-specific guidance.
Recommendations
- Provide Linux-specific troubleshooting steps and examples for all major scenarios, especially those currently described only for Windows.
- Include Linux command-line equivalents for PowerShell commands (e.g., systemctl/service commands for agent management).
- Add guidance for Linux log locations and diagnostic tools analogous to Windows event logs.
- Ensure parity in detail and coverage between Windows and Linux sections, including configuration file locations and update/upgrade caveats.
- Where possible, present platform-agnostic troubleshooting steps before platform-specific ones.
Create Pull Request