Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. While the main focus is on Azure CLI (which is cross-platform), several examples and instructions explicitly mention Windows-specific shells (CMD, PowerShell) and provide syntax for those before or instead of equivalent Linux/Bash examples. There are references to escaping quotes and array syntax for Windows shells, but Linux/Bash alternatives are either less detailed or mentioned secondarily. No explicit Linux tools or patterns are highlighted, and there is little guidance for Linux users beyond generic Bash usage.
Recommendations
- Ensure all shell-specific examples (e.g., passing arrays, setting variables) are provided for both Windows (CMD/PowerShell) and Linux (Bash) side-by-side, with equal detail.
- Where shell differences are discussed, present Linux/Bash syntax first or equally, not as an afterthought.
- Add explicit notes or sections for Linux users, such as common pitfalls, file path conventions, and troubleshooting tips.
- Include references to Linux-native tools or patterns (e.g., using curl, jq, or bash scripting techniques) where relevant.
- Review examples for any implicit Windows assumptions (e.g., file paths, environment variables) and clarify cross-platform compatibility.
Create Pull Request