Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation generally maintains cross-platform neutrality, but there are subtle Windows biases. In several places, Windows conventions (e.g., Ctrl+Shift+P, Ctrl+Z) are mentioned first, with macOS alternatives as parentheticals or afterthoughts. When showing how to retrieve Azure resource IDs, Azure CLI and Azure PowerShell are both presented, but PowerShell is given its own tab, and Windows-centric tools (PowerShell, Azure portal) are mentioned before Linux alternatives. No explicit Linux/macOS examples or screenshots are provided, and the documentation does not highlight Linux-specific workflows or issues.
Recommendations
- Present keyboard shortcuts for Windows and macOS equally (e.g., Ctrl+Shift+P / Cmd+Shift+P) in all instances.
- When listing command-line tools, mention Azure CLI before or alongside Azure PowerShell, as CLI is cross-platform.
- Include Linux/macOS-specific notes or screenshots where relevant (e.g., file dialogs, terminal usage).
- Add troubleshooting tips for Linux/macOS users, such as permissions or path differences.
- Explicitly state that all features and commands work on Linux/macOS, or note any exceptions.
Create Pull Request