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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation consistently presents PowerShell (a Windows-centric tool) examples before Azure CLI, and the PowerShell examples use Windows file paths (e.g., c:\Templates\azuredeploy.json) without offering Linux/macOS equivalents. There is no explicit mention or example for Linux/macOS users regarding file paths or shell differences, and the CLI section only briefly notes that Bash syntax may differ in other environments without providing concrete Linux/macOS alternatives.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI first to avoid implicit Windows prioritization.
- For file paths, provide both Windows (e.g., c:\Templates\azuredeploy.json) and Linux/macOS (e.g., ~/Templates/azuredeploy.json) examples in relevant commands.
- Explicitly mention and provide examples for Linux/macOS users, especially where shell syntax or environment variables differ (e.g., use $HOME or ~/ for paths, note differences in date command usage).
- Clarify in the introductory text that both Windows and Linux/macOS are supported, and link to platform-specific guidance if available.
- Where PowerShell is referenced, clarify that PowerShell Core is cross-platform, or provide Bash/zsh alternatives for Linux/macOS users.
Create pull request