Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias by providing only PowerShell scripts and examples for deploying Arc-enabled Managed SQL Instance in an Extended Zone. There are no Bash or Linux shell equivalents, and all command-line instructions are shown in PowerShell syntax, which is native to Windows. This can create friction for Linux/macOS users, who typically use Bash or other shells and may not be familiar with PowerShell scripting.
Recommendations
- Provide equivalent Bash shell scripts and examples alongside PowerShell, especially for steps involving Azure CLI and resource creation.
- Explicitly state that Azure CLI commands can be run in Bash, and show syntax differences if any.
- Add notes or sections highlighting cross-platform usage, including how Linux/macOS users can adapt the instructions.
- Avoid using PowerShell-specific constructs (e.g., `$ENV:`, `[string]`, `Write-Output`) in generic Azure CLI workflows, or provide alternatives.
- Where possible, use Azure CLI commands in plain shell syntax, which is portable across platforms.
Create Pull Request