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 demonstrates a Windows bias by presenting Azure PowerShell commands alongside Azure CLI, but with CLI examples referencing Bicep files (not ARM JSON), and PowerShell being used for cleanup. There are no explicit Linux shell or cross-platform cleanup examples, and the PowerShell example is the only one provided for deleting resources. The use of 'azurepowershell-interactive' for cleanup further centers Windows tooling. Additionally, the Azure Portal (web UI) is platform-agnostic but is not a substitute for command-line parity.
Recommendations:
- Provide equivalent Bash (Linux/macOS) cleanup commands using Azure CLI, e.g., 'az group delete --name <resourceGroupName>'.
- Ensure that ARM template deployment examples use the same template file (e.g., 'azuredeploy.json') for both CLI and PowerShell, and show both commands side-by-side.
- Avoid using only PowerShell for interactive scripts; provide Bash alternatives or use Azure CLI for all cross-platform scenarios.
- Clearly label which commands are cross-platform and which are Windows-specific, and avoid defaulting to PowerShell for tasks that can be accomplished with Azure CLI.
- Consider including a table summarizing all deployment and cleanup options for Windows, Linux, and macOS users.
Create pull request