Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for command-line operations, but PowerShell examples are consistently presented after CLI examples and in greater detail, including advanced usage (background jobs, object inspection). There is a notable emphasis on PowerShell-specific patterns and terminology, which are native to Windows environments. No Linux/macOS-specific shell examples (e.g., Bash) are given, and PowerShell is treated as a primary tool for scripting and automation, which may create friction for Linux/macOS users.
Recommendations
- Add explicit Bash shell examples for REST API calls using curl, especially in sections describing REST usage.
- Clarify that Azure CLI is cross-platform and can be used equally on Linux/macOS/Windows.
- Balance the level of detail between PowerShell and CLI examples, ensuring CLI examples cover advanced scenarios (e.g., asynchronous operations, filtering, background execution) where possible.
- Mention that Azure PowerShell is available cross-platform, but highlight CLI and REST as first-class options for Linux/macOS users.
- Consider reordering examples to present CLI before PowerShell or interleave them to avoid implicit prioritization.
Create Pull Request