Bias Analysis
Detected 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