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 Azure CLI and Azure PowerShell examples for configuring Key Vault references, but PowerShell examples are consistently presented immediately after the CLI, and no Linux shell-specific (e.g., Bash) or cross-platform scripting examples are given. The use of PowerShell, which is traditionally associated with Windows, may create a perception of Windows bias, especially as Linux users may expect Bash or shell script examples. However, the CLI examples are cross-platform, which mitigates some of the bias.
Recommendations:
- Explicitly note that Azure CLI commands are cross-platform and suitable for Linux, macOS, and Windows.
- Where PowerShell is shown, consider also providing Bash or shell script equivalents for Linux users, especially for scripting scenarios involving variables or more complex logic.
- In tabbed code blocks, consider listing Bash or Azure CLI first (or clarify that CLI is cross-platform), and PowerShell second, to avoid the impression of Windows-first bias.
- Add a brief section or note clarifying that all management operations can be performed from Linux environments using the Azure CLI.
- If there are any platform-specific caveats (e.g., for Linux App Service), highlight them clearly and provide Linux-specific troubleshooting steps or examples where relevant.
Create pull request