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 consistently presents PowerShell (typically used on Windows) examples before Azure CLI (cross-platform) examples. File paths in PowerShell examples use Windows-style paths (e.g., c:\Templates\azuredeploy.json), and there is no explicit mention or example of uploading templates from a Linux or macOS environment (e.g., using Unix-style paths). The Azure CLI section references Bash in Cloud Shell but does not provide parity for local Linux/macOS environments or address differences in shell syntax. There are no Linux-specific troubleshooting notes or examples.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI (cross-platform) first.
- In upload examples, provide both Windows (c:\...) and Linux/macOS (~/Templates/...) file path examples.
- Explicitly mention that Azure CLI commands work on Linux/macOS and provide any necessary syntax adjustments (e.g., for date/time formatting).
- Add notes or tabs for Linux/macOS users where shell syntax or environment variables may differ.
- In 'Next steps', include links to documentation for deploying templates using Azure CLI on Linux/macOS.
Create pull request