Bias Analysis
Detected Bias Types
windows_tools
windows_first
Summary
The documentation page demonstrates mild Windows bias by exclusively using Azure CLI (az) and jq in all shell examples, which are most commonly installed and used on Windows systems. There is no mention of Linux/macOS-specific CLI usage, nor are there any PowerShell-specific examples, but the CLI commands and tooling are presented without explicit cross-platform guidance. The documentation does not discuss Linux/macOS installation or usage considerations for az or jq, nor does it provide alternative commands for environments where jq may not be available. However, the examples themselves are written in bash, which is available on Linux/macOS and, via WSL, on Windows, mitigating the impact.
Recommendations
- Explicitly state that the Azure CLI and jq commands are cross-platform and provide installation instructions for Linux/macOS.
- Add notes or examples for Linux/macOS users, such as alternative ways to extract JSON values without jq (e.g., using Python or built-in shell tools).
- Clarify that the bash examples work natively on Linux/macOS and via WSL or Git Bash on Windows.
- Consider providing PowerShell examples for Windows-only users, or at least mention their availability elsewhere.
- Add troubleshooting notes for common cross-platform issues (e.g., path differences, environment variables).
Create Pull Request