Document Details
Connectors Troubleshooting Guide
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides troubleshooting steps for both Bash and PowerShell users, but PowerShell (Windows) examples and tools are consistently presented alongside or immediately after Bash, sometimes with additional detail for PowerShell. In some sections, PowerShell-specific troubleshooting (e.g., updating modules, error preferences) is included, while equivalent Linux/macOS guidance is missing. The order of presentation is generally Bash first, but Windows/PowerShell content is given equal or slightly more prominence, and some PowerShell-specific issues are addressed that have no Bash equivalent.
Recommendations
- Add Linux/macOS-specific troubleshooting steps where only PowerShell/Windows guidance is given (e.g., Bash error handling, module updates).
- Ensure parity in detail between Bash and PowerShell sections, avoiding extra troubleshooting for PowerShell unless Bash/Linux equivalents are also covered.
- Where PowerShell-specific advice is given (like $ErrorActionPreference), include Bash/Linux error handling tips (e.g., set -e, error traps).
- Explicitly mention support for macOS where relevant, and clarify any platform-specific limitations.
- Consider grouping Bash and PowerShell guidance separately to reduce cognitive friction for non-Windows users.
Create Pull Request
Clean