Bias Analysis
Detected Bias Types
powershell_heavy
missing_linux_example
windows_tools
windows_first
Summary
The documentation provides only PowerShell-based deployment instructions for both ARM and Bicep templates, specifically referencing Azure Cloud Shell and the New-AzResourceGroupDeployment cmdlet. There are no examples using Azure CLI, Bash, or Linux-native tooling. The deployment steps are written with a Windows/PowerShell-first perspective, and there is no mention of Linux or cross-platform alternatives.
Recommendations
- Add Azure CLI (az deployment group create) examples for deploying both ARM and Bicep templates, alongside or before PowerShell examples.
- Explicitly mention that Azure Cloud Shell supports both Bash and PowerShell, and provide Bash/CLI instructions.
- Ensure that all scripts and commands are cross-platform or provide platform-specific alternatives (e.g., Bash for Linux/macOS, PowerShell for Windows).
- Update the documentation to avoid implying PowerShell is the default or only supported method for deployment.
- Where possible, use generic terms like 'run the following command' instead of 'run the following PowerShell script', unless only PowerShell is supported.
Create Pull Request