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.