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
Summary:
The documentation provides both Azure CLI and PowerShell examples throughout, but the PowerShell examples are prominent and sometimes more detailed (e.g., handling secure strings). The PowerShell examples use Windows-specific cmdlets and patterns, and the documentation references Windows scenarios (such as installing a certificate on a Windows VM) before mentioning general or cross-platform scenarios. There is no mention of Linux-specific tools, shell scripting, or guidance for Linux users, and the PowerShell examples assume a Windows environment.
Recommendations:
- Explicitly mention that Azure CLI is cross-platform and suitable for Linux, macOS, and Windows.
- Add Bash shell scripting examples alongside PowerShell, especially for parameter file creation and deployment steps.
- When referencing VM scenarios, provide both Windows and Linux quickstart links or examples.
- Clarify that PowerShell Core is available cross-platform, but provide Bash alternatives for Linux users.
- Ensure that any advanced scripting (such as secure string handling) has a Linux/Bash equivalent.
- Review and balance the order of examples so that Azure CLI (cross-platform) is presented first, or alternate the order to avoid implicit Windows-first bias.
Create pull request