Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation demonstrates a Windows bias by prioritizing PowerShell instructions, referencing Windows-specific tools (such as Git Bash for CLI usage), and providing examples and guidance that assume a Windows environment. Linux-native shells and workflows are not discussed, and the CLI instructions reuse Windows-centric file paths and context. There is a lack of explicit Linux or macOS examples, and the documentation does not address cross-platform differences in detail.
Recommendations
- Add explicit Linux/macOS instructions and examples, including native Bash shell usage and file path conventions.
- Avoid recommending Windows-specific tools (e.g., Git Bash) as the default for CLI usage; mention standard Bash shells available on Linux/macOS.
- Provide guidance for running Azure CLI commands in Linux/macOS terminals, including differences in environment variables and file paths.
- Ensure that CLI examples use forward slashes (/) for file paths and avoid Windows-style backslashes (\\) unless specifically targeting Windows.
- Include troubleshooting notes for common cross-platform issues (e.g., permission errors, shell differences).
- Balance the prominence of PowerShell and CLI instructions, and consider listing CLI (cross-platform) instructions before PowerShell (Windows-centric) ones.
Create Pull Request