Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides detailed PowerShell examples and instructions before CLI examples, which may indicate a Windows-first bias. The PowerShell section is more verbose, with installation and connection steps, while the CLI section is more concise. There are no Linux/macOS-specific instructions or examples, and PowerShell is a Windows-centric tool, though it is available on other platforms. The CLI examples are cross-platform, but the prominence and detail of PowerShell may create friction for Linux/macOS users.
Recommendations
- Add explicit Linux/macOS instructions for Azure CLI installation and usage.
- Clarify that Azure CLI is cross-platform and recommend it as the default for non-Windows users.
- Provide parity in example detail between PowerShell and CLI sections (e.g., include authentication steps for CLI).
- Consider reordering sections to present CLI examples before PowerShell, or present both side-by-side.
- Mention that PowerShell Core is available on Linux/macOS, if relevant, and provide installation links.
Create Pull Request