Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides example commands for Azure CLI, Azure PowerShell, ARM templates, and the Azure portal. However, the PowerShell example is detailed and multi-step, while the Azure CLI example is a single command with minimal explanation. There is no mention of Linux/macOS-specific considerations, nor is there parity in example depth for CLI usage on Linux. PowerShell is a Windows-centric tool, and its example is given more prominence and detail than the CLI, which is cross-platform. The ordering of examples also places PowerShell before the portal, which is more OS-neutral.
Recommendations
- Expand the Azure CLI section to include step-by-step instructions equivalent to the PowerShell example, ensuring Linux/macOS users have clear guidance.
- Explicitly mention that Azure CLI is cross-platform and suitable for Linux/macOS users.
- Add notes or links for installing and using Azure CLI on Linux/macOS.
- Consider reordering examples to present CLI before PowerShell, or group them as 'cross-platform' and 'Windows-specific'.
- If PowerShell Core is supported on Linux/macOS, clarify this and provide installation guidance.
Create Pull Request