About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Bias Types:
⚠️
powershell_heavy
⚠️
windows_first
Summary:
The documentation provides both Bash and PowerShell examples for Azure CLI commands, but the PowerShell examples are labeled as 'Formatted for PowerShell' and are always presented immediately after the Bash examples. There is no explicit mention of Linux or macOS, and the PowerShell examples may suggest a Windows-first approach. However, both platforms are represented, and no examples are missing for Linux users.
Recommendations:
- Explicitly label Bash examples as suitable for Linux/macOS and PowerShell examples as suitable for Windows.
- Present both Bash and PowerShell examples in parallel tabs or sections, rather than sequentially, to avoid the impression of prioritizing one platform.
- Add a short introductory note clarifying that the Azure CLI works on all platforms and that users should choose the example matching their shell environment.
- Ensure that any references to shell-specific syntax (e.g., variable assignment, string manipulation) are explained or linked to relevant documentation for both Bash and PowerShell.
Create pull request