Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation lists methods for discovering Azure Policy aliases, presenting the Visual Studio Code extension (cross-platform) first, but then gives Azure PowerShell examples before Azure CLI and REST API. The PowerShell section is more detailed, including advanced usage notes and examples, while the Azure CLI section is shorter and less emphasized. This ordering and depth may create friction for Linux/macOS users, as PowerShell is primarily associated with Windows, and CLI is more common on Linux/macOS.
Recommendations
- Provide equally detailed examples and advanced usage notes for Azure CLI, matching those given for PowerShell.
- Consider listing Azure CLI before PowerShell, or presenting both together, to avoid implicit prioritization.
- Explicitly mention cross-platform compatibility for each tool, especially for PowerShell Core and Azure CLI.
- Add links or notes for installing Azure CLI and PowerShell on Linux/macOS.
- Ensure screenshots and walkthroughs are not Windows-centric (e.g., show CLI usage in Linux terminal).
Create Pull Request