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 examples and instructions are consistently presented alongside or immediately after Bash, sometimes with additional detail for PowerShell (e.g., file locking). There is a notable emphasis on Azure PowerShell module management and error handling, which are Windows-centric patterns. No Linux-specific troubleshooting (e.g., shell environment issues, file permissions beyond chmod) or tool alternatives are mentioned. The documentation assumes parity between Bash and PowerShell but leans toward Windows/PowerShell usage patterns.
Recommendations
- Ensure Linux/Bash examples are presented first or given equal prominence.
- Add Linux-specific troubleshooting steps, such as handling file permissions, environment variables, and common shell errors.
- Include guidance for updating Azure CLI on Linux (e.g., apt, yum, zypper commands).
- Mention cross-platform considerations, such as differences in file path formats and script execution environments.
- Clarify when instructions are platform-specific and provide alternatives for macOS and Linux users.
- Avoid assuming PowerShell is available on all platforms; note installation steps for PowerShell Core on Linux/macOS if relevant.
Create Pull Request
Clean