Bias Analysis
Detected Bias Types
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a bias toward Windows environments by exclusively using Visual Studio Code and its extensions (such as the SQL Server extension), and by referencing workflows and tools that are most commonly used on Windows. There are no examples or guidance for Linux-native tools (e.g., sqlcmd, Azure Data Studio, or command-line SQL clients), nor are alternative Linux-friendly workflows mentioned. The instructions assume the use of GUI tools and patterns typical of Windows development environments, with no parity for Linux command-line or non-VS Code scenarios.
Recommendations
- Add explicit instructions and examples for connecting to Azure SQL Database using Linux-native tools such as sqlcmd, Azure Data Studio, or psql (for PostgreSQL).
- Include command-line alternatives for all steps that currently rely on Visual Studio Code GUI features, such as running azd commands and connecting to the database.
- Mention installation and usage of Azure Functions Core Tools on Linux, including any prerequisites or differences.
- Provide troubleshooting notes or links for common Linux issues (e.g., authentication, environment variables, file permissions).
- Ensure that all code and deployment steps are demonstrated in both GUI and CLI contexts, and clarify that the azd CLI and Azure Functions Core Tools are cross-platform.
Create Pull Request