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
Summary:
The documentation provides both Azure CLI and PowerShell examples for deploying and managing Azure Cache for Redis resources. However, PowerShell (a Windows-centric tool) is given equal prominence to Azure CLI in all code example tabs, and is always presented immediately after CLI, rather than being de-emphasized or separated. There are no Linux-specific shell examples (e.g., Bash), and no mention of Linux tooling or patterns. The documentation assumes parity between CLI and PowerShell, but does not clarify that PowerShell is primarily a Windows tool, nor does it highlight Linux workflows or considerations.
Recommendations:
- Explicitly mention that Azure CLI is cross-platform and available on Linux, macOS, and Windows, while PowerShell examples are primarily for Windows users.
- Add Bash shell examples or clarify that Azure CLI commands can be run in Bash on Linux/macOS.
- Consider presenting CLI (Bash) examples first, and PowerShell examples second, to avoid implicit Windows-first bias.
- Add a note or section about installing and using Azure CLI on Linux, and link to relevant documentation.
- Where appropriate, provide Linux-specific troubleshooting or environment setup tips.
Create pull request
Flagged Code Snippets
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep
New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep -existingDiagnosticsStorageAccountName "<storage-name>" -existingDiagnosticsStorageAccountResourceGroup "<resource-group>"
# [PowerShell](#tab/PowerShell)
# [PowerShell](#tab/PowerShell)