Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a moderate Windows bias. While the main examples use Azure CLI, which is cross-platform, there are several instances where Windows-specific shells (CMD, PowerShell) are mentioned before or instead of Linux equivalents. For example, instructions for passing arrays and setting variables provide Windows syntax and escaping guidance, but do not equally detail Linux/Bash alternatives. There is also a lack of explicit Linux/Bash examples in sections discussing variable assignment and parameter passing, and no mention of Linux-specific tooling or patterns. The page does not provide parity in examples for Linux users, and Windows terminology and patterns are often presented first.
Recommendations
- Add explicit Bash/Linux examples wherever Windows CMD/PowerShell syntax is shown, especially for variable assignment and parameter passing.
- When discussing shell-specific syntax, present Linux/Bash examples before or alongside Windows examples to avoid Windows-first ordering.
- Include notes or sections on common Linux patterns and troubleshooting, such as file permissions, path formats, and environment variables.
- Ensure that all CLI commands are tested and shown to work on both Windows and Linux shells, and clarify any differences.
- Where possible, use neutral, cross-platform syntax in examples, or provide side-by-side examples for both platforms.
Create Pull Request