Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides Azure CLI examples that are mostly shell-agnostic, but there is a notable tendency to mention Windows-specific shells (CMD, PowerShell) and their syntax before or in more detail than Linux/macOS equivalents. Some examples and explanations are tailored for Windows users, with Linux/Bash alternatives presented secondarily or not at all. There are references to escaping quotes and variable assignment in PowerShell/CMD, but less explicit guidance for Linux/macOS users. No Linux-specific tools or patterns are discussed, and the documentation does not provide parity in example ordering or depth.
Recommendations
- Present Linux/Bash and Windows/PowerShell examples side-by-side, or alternate which comes first.
- Provide explicit examples for Linux/macOS users where Windows-specific syntax is discussed (e.g., variable assignment, array formatting).
- Include notes on differences in quoting, escaping, and parameter passing between shells.
- Add troubleshooting tips for common Linux/macOS issues (e.g., file permissions, path formats).
- Ensure that all examples are tested and work on Linux/macOS, not just Windows.
Create Pull Request