Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation presents Azure PowerShell instructions before Azure CLI, which can be perceived as a Windows-first bias. While Azure CLI is cross-platform and included, there are no explicit Linux/macOS-specific instructions or terminal usage examples. The verification and cleanup steps rely solely on the Azure Portal GUI, which is platform-agnostic but omits command-line alternatives that Linux users may prefer. No Linux-specific tools or shell examples (e.g., Bash scripting, use of environment variables in Bash) are provided.
Recommendations
- Present Azure CLI instructions before PowerShell, or at least in parallel, to avoid a Windows-first impression.
- Explicitly mention that Azure CLI commands work on Linux, macOS, and Windows, and provide example terminal commands using Bash syntax (e.g., export, $HOME).
- Include instructions for verifying deployment and cleaning up resources using Azure CLI commands, not just the Azure Portal.
- Where variables are referenced (e.g., $templateFile), show both PowerShell and Bash syntax for setting them.
- Consider adding a short section or callout for Linux/macOS users, highlighting any differences or tips.
Create Pull Request