Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation exhibits a moderate Windows bias. It provides explicit PowerShell examples and references to PowerShell commands (e.g., Get-AzLocation) without offering equivalent Azure CLI or bash examples, which are more common on Linux/macOS. The tabs for modifying templates are 'portal' and 'PowerShell', with no mention of Azure CLI or bash scripting. Windows tools and patterns (PowerShell) are referenced before any Linux-friendly alternatives, and there are no explicit Linux/macOS-specific instructions or examples.
Recommendations
- Add Azure CLI examples for all steps currently shown with PowerShell, especially for obtaining region codes and deploying templates.
- Include bash script snippets where relevant, particularly for template manipulation and deployment.
- Present Azure CLI and PowerShell examples side-by-side, or use tabs for 'Azure CLI', 'PowerShell', and 'Portal' to ensure parity.
- Explicitly mention that all steps can be performed on Linux/macOS using Azure CLI.
- Reference cross-platform tools (e.g., az command) before or alongside Windows-specific tools.
Create Pull Request