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 page demonstrates a Windows-first bias by providing a PowerShell (az CLI) example for deploying the ARM template but omitting equivalent Linux/macOS shell (bash) examples. The only command-line deployment example is shown using PowerShell syntax, and there is no mention of Linux or cross-platform CLI usage, nor are there instructions for using bash or other common Linux tools. The Azure portal is referenced, which is cross-platform, but the CLI example is Windows-centric.
Recommendations:
- Provide both PowerShell and bash (Linux/macOS) examples for CLI commands, especially for az deployment group create.
- Explicitly mention that the Azure CLI can be used on Windows, Linux, and macOS, and show syntax for both environments where it differs.
- Consider using neutral CLI syntax (e.g., $HOME or ~ for home directory, forward slashes in paths) or clarify any OS-specific differences.
- Add a note or section for Linux/macOS users, ensuring parity in instructions and examples.
- Where possible, use 'az' CLI commands in a way that is copy-paste friendly for all platforms.
Create pull request