Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides both Azure CLI and Azure PowerShell examples for managing access keys, but the PowerShell examples are more detailed and prominent. PowerShell is a Windows-centric tool, and there are no explicit Linux shell (bash) or cross-platform scripting examples beyond Azure CLI. In some cases, PowerShell scripts are provided with detailed variable setup and REST API usage, while the CLI examples are simpler. Additionally, the documentation notes that the Azure CLI example is designed for Azure Cloud Shell (Bash) and must be modified for Windows, but does not provide a native Linux terminal/bash example outside of Cloud Shell. There is a subtle 'windows_first' bias in the prominence and detail of PowerShell content, and a lack of parity for Linux users who may want bash or scripting examples outside of Cloud Shell.
Recommendations
- Add explicit bash/Linux shell script examples for all CLI operations, not just Azure Cloud Shell, to ensure Linux users have clear, native instructions.
- Balance the level of detail between PowerShell and CLI/bash examples, ensuring both platforms have equally comprehensive guidance.
- Where PowerShell is used for REST API calls, provide equivalent curl or HTTPie examples for Linux/macOS users.
- Clarify in each example whether it is cross-platform, and if not, provide platform-specific alternatives.
- Consider including a table or section summarizing which tools are available and recommended for Windows, Linux, and macOS environments.
Create Pull Request