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:
⚠️
windows_first
⚠️
powershell_heavy
⚠️
missing_linux_example
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for managing access keys, but the PowerShell examples are detailed and prominent, and there is no explicit mention or example for Linux shell scripting or Bash outside of Azure CLI. The CLI examples are stated to run in Azure Cloud Shell (Bash), but there is a note that they must be modified to run in a Windows terminal, suggesting a Windows-first perspective. No Linux-specific tools or shell script examples are provided, and PowerShell is presented as a primary scripting method.
Recommendations:
- Add explicit Bash or shell script examples for key management tasks, especially for scenarios where scripting is needed outside of Azure CLI.
- Clarify that Azure CLI commands work natively on Linux, macOS, and Windows, and provide any necessary notes for cross-platform usage.
- Balance the prominence of PowerShell and CLI examples by ensuring that Linux/Bash scripting is equally represented, especially for automation scenarios.
- Where PowerShell scripts are provided, offer equivalent Bash scripts for users who may not use PowerShell.
- Avoid language that implies Windows is the default or primary environment (e.g., 'You must modify it to run in a Windows terminal'), and instead provide parallel guidance for both Windows and Linux users.
Create pull request