Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page provides Azure CLI examples for ARM template deployment, but several sections show a Windows-first bias. Windows-specific shells (CMD, PowerShell) are mentioned before Linux equivalents, and example syntax for Windows is given more prominence or detail. There are references to escaping quotes and passing arrays/objects in Windows shells, but Linux/Bash alternatives are less detailed or sometimes omitted. No explicit Linux tools or patterns are highlighted, and the documentation does not provide parity in example coverage for Linux users.
Recommendations
- Ensure that examples for Bash/Linux shells are given equal prominence and detail as Windows CMD/PowerShell examples.
- When describing parameter passing, provide explicit Bash/Linux syntax first or alongside Windows syntax, rather than after.
- Include troubleshooting tips or notes for common Linux/Bash issues (e.g., quoting, file paths) as are done for Windows.
- Add references to Linux-specific tools or patterns where relevant (e.g., using curl, jq, or other CLI utilities).
- Review all example blocks to ensure Linux users are not required to infer syntax from Windows examples.
- Consider a dedicated section for cross-platform differences, or use tabs/switchers for Windows/Linux/Mac examples.
Create Pull Request