Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides command-line examples for Azure CLI and Azure PowerShell, with PowerShell examples included and presented in parallel to CLI. While the CLI is cross-platform, PowerShell is primarily associated with Windows, and its inclusion may signal a Windows bias. Additionally, in tabbed sections, Azure portal instructions (which are browser-based and OS-neutral) are shown first, but PowerShell examples are always present, and there are no explicit Linux/macOS shell examples (e.g., Bash, curl, etc.). There is no mention of Linux-specific tools or patterns, and the documentation does not clarify that PowerShell Core is available cross-platform.
Recommendations
- Add explicit Bash/shell examples for Linux/macOS users where appropriate, especially for querying with Azure CLI.
- Clarify that Azure CLI commands work on all platforms, and that PowerShell Core is available cross-platform if relevant.
- Consider adding notes or examples using common Linux tools (e.g., curl, jq) for tasks involving JSON output.
- Ensure that PowerShell is not presented as the default or primary method unless necessary; keep CLI examples prominent.
- Add a short section or callout for Linux/macOS users to highlight any platform-specific considerations.
Create Pull Request