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 in several sections, PowerShell examples and instructions are given equal or greater prominence than Bash/Linux equivalents. Some troubleshooting steps (e.g., updating modules, error handling preferences) are specific to PowerShell/Windows and lack direct Linux/Bash analogs or guidance. In some cases, PowerShell instructions are presented before Bash, and additional details are given for PowerShell users (e.g., file locking).
Recommendations
- Ensure that Bash/Linux instructions are presented first or in parallel with PowerShell/Windows instructions.
- Where PowerShell-specific troubleshooting is given (e.g., module updates, error handling), provide equivalent Bash/Linux guidance (e.g., updating Azure CLI, handling errors in Bash scripts).
- Add notes for Linux/macOS users where Windows-specific issues (like file locking) are mentioned, clarifying if/how these issues may differ.
- Where possible, unify instructions so that both Bash and PowerShell users receive parity in troubleshooting detail and order.
- Consider adding a table or clear separation for Bash/Linux vs. PowerShell/Windows steps to avoid confusion.
Create Pull Request
Clean