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:
⚠️
powershell_heavy
⚠️
windows_first
⚠️
windows_tools
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for deploying templates with parameter files. However, the PowerShell example uses a Windows-style file path (C:\MyTemplates\...), and the PowerShell section appears before any mention of Linux shell equivalents or cross-platform scripting. Additionally, the 'Parameter name conflicts' section discusses PowerShell-specific behavior without mentioning how this might differ in other environments. The Visual Studio tip is also Windows-centric. There are no explicit Linux shell or scripting examples, and no mention of Linux-specific tools or patterns.
Recommendations:
- Include Linux shell (bash) examples alongside PowerShell, especially for file paths and scripting.
- Use cross-platform file paths in examples (e.g., ./MyTemplates/storage.parameters.json) or show both Windows and Linux variants.
- Clarify PowerShell-specific behaviors (such as parameter name conflicts) and note if/how they differ in other environments.
- Add tips or notes for users working on Linux or macOS, especially regarding file system conventions and editor integration.
- Balance the order of examples, sometimes presenting Linux/CLI first or side-by-side with Windows/PowerShell.
Create pull request