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
Bias Types:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias by presenting Windows and PowerShell-based instructions before Linux/macOS equivalents, requiring WSL for Windows users, and referencing Windows-specific tools and path conventions. Linux and macOS instructions are less detailed and sometimes only mentioned after Windows steps. There is also an emphasis on Docker Desktop (with a Windows install link) and WSL configuration, while native Linux workflows are less emphasized.
Recommendations:
- Present Linux/macOS instructions alongside or before Windows instructions, or use parallel tabbed sections for each OS.
- Provide native Linux and macOS setup steps with equal detail, including terminal commands and file path conventions.
- Avoid requiring WSL for Windows users unless absolutely necessary; if used, clarify why and provide alternatives.
- Include Linux and macOS Docker installation links in prerequisites, not just Windows.
- When referencing file paths, show both Windows and Unix-style examples.
- Ensure all scripts and commands are demonstrated for both PowerShell/Windows and Bash/Linux environments.
- Where possible, use cross-platform tools and language in examples, minimizing Windows-specific terminology.
Create pull request
Flagged Code Snippets
cd <path to your common scripts folder> # Update this path
2. Issue wsl command to open WSL at this directory.
> [!IMPORTANT]
>
> - By passing the value "Y" to the environment variable "ACCEPT_EULA", you are acknowledging and accepting the terms and conditions of the End User License Agreement (EULA) for both [Azure Service Bus emulator](https://github.com/Azure/azure-service-bus-emulator-installer/blob/main/EMULATOR_EULA.txt) and [Azure SQL Edge](https://go.microsoft.com/fwlink/?linkid=2139274).
>
> - Ensure to place .env file in same directory to docker-compose.yaml file.
>
> - Set the MSSQL_SA_PASSWORD environment variable to a strong password of at least eight characters that meets the [password requirements](/sql/relational-databases/security/password-policy).
> - When specifying file paths in Windows, use double backslashes (`\\`) instead of single backslashes (`\`) to avoid issues with escape characters.
4. To run the emulator, execute following command:
- Application containers on the different bridge network can interact with Emulator using the "host.docker.internal" as host. Use following connection string: