Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for REST, Azure PowerShell, and Azure CLI when creating EA subscriptions, but PowerShell is given a prominent position, including explicit instructions to use Azure Cloud Shell with PowerShell. The PowerShell tab appears before Azure CLI, and references to installing PowerShell modules are present. There is no mention of Bash or Linux/macOS-specific shell usage, nor are there any examples or notes about platform differences for CLI or REST usage. For MCA and MPA accounts, only REST API examples are provided, which are platform-neutral. However, the overall pattern and ordering suggest a mild Windows/PowerShell bias, especially in the EA section.
Recommendations
- Add explicit notes that Azure CLI and REST API examples work equally well on Linux, macOS, and Windows.
- Instruct users that Azure Cloud Shell supports both Bash and PowerShell, and provide Bash examples or clarify that CLI commands can be run in Bash.
- Reorder example tabs so that Azure CLI appears before PowerShell, or alternate ordering in different sections.
- Where PowerShell module installation is discussed, provide equivalent instructions for Azure CLI installation on Linux/macOS.
- Add a brief section or callout confirming cross-platform compatibility for all API and CLI commands.
Create Pull Request