Bias Analysis
Detected Bias Types
windows_first
windows_tools
missing_linux_example
windows_plan_required
Summary
The documentation page demonstrates a notable Windows bias. Windows-based App Service plans are required for hosting, with explicit instructions not to use Linux-based plans. All example hosting plans reference Windows. Tooling references are Microsoft-centric (Visual Studio Code, Azure Functions Core Tools MSI installer), with no mention of Linux package managers or alternatives. There are no examples or instructions for Linux or macOS users, such as connecting to SQL Server from Linux, using Linux-based SQL servers, or deploying from Linux environments. The documentation assumes a Windows-first approach throughout critical deployment steps.
Recommendations
- Provide explicit instructions and examples for Linux/macOS users, including how to set up SQL Server on Linux and connect from Linux environments.
- Clarify whether Linux-based App Service plans will be supported in the future, or explain the technical reasons for the Windows-only requirement.
- Include alternative installation instructions for Azure Functions Core Tools using Linux package managers (e.g., apt, yum, Homebrew) alongside the MSI installer.
- Add notes or sections for common Linux/macOS development workflows, such as using SQL Server on Docker, connecting from Linux terminals, or deploying from non-Windows hosts.
- If Windows-only is a hard technical requirement, make this clear early in the documentation and provide guidance for Linux/macOS users on possible workarounds (e.g., using Azure-hosted Windows environments).
Create Pull Request