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 demonstrates a Windows bias by presenting PowerShell examples alongside Azure CLI, but omits explicit Linux/bash examples. PowerShell is used for both deployment and cleanup, and the CLI example references a Bicep file rather than the ARM template file described earlier. There are no bash shell or Linux-specific instructions, and PowerShell is presented as the default scripting language for resource cleanup.
Recommendations:
- Add explicit bash/Linux shell examples for deploying and cleaning up resources, using az CLI with ARM template files (e.g., az deployment group create --resource-group exampleRG --template-file azuredeploy.json).
- Ensure that CLI examples reference the ARM template file (azuredeploy.json) as described in the instructions, not just Bicep files.
- Provide parity in cleanup instructions by including az CLI commands for deleting resource groups (e.g., az group delete --name <resourceGroupName> --yes --no-wait).
- Where scripting is shown, offer both PowerShell and bash equivalents, and avoid presenting PowerShell as the default unless the context is Windows-specific.
- Consider a tabbed or side-by-side format for all command-line examples, with clear labels for PowerShell, Azure CLI (bash), and, if relevant, Cloud Shell.
Create pull request