Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides examples for Azure Portal, CLI, PowerShell, and REST API. However, PowerShell is given equal prominence to CLI, despite being Windows-centric. There are no explicit Linux/macOS shell examples (e.g., Bash), and PowerShell examples may not be directly usable on non-Windows platforms. The CLI examples are cross-platform, but the absence of Linux/macOS-specific shell scripting or explicit mention of Linux usage creates mild friction for non-Windows users.
Recommendations
- Clarify that PowerShell examples are primarily for Windows users and recommend CLI for Linux/macOS users.
- Add explicit Bash shell examples for common tasks, especially in sections where PowerShell is shown.
- Where possible, note platform compatibility for each example (e.g., 'CLI: works on Windows, Linux, macOS; PowerShell: Windows only').
- Consider reordering examples to show CLI before PowerShell, emphasizing cross-platform tools.
- Add links or references to Linux/macOS-specific documentation where relevant.
Create Pull Request