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
⚠️
windows_tools
Summary:
The documentation generally maintains parity between Azure PowerShell and Azure CLI, and explicitly states that CLI examples are written for Bash (Linux/macOS). However, there is a subtle Windows bias in the ordering and tool recommendations: Windows tools and installation instructions are listed before Linux/macOS equivalents, and Visual Studio Code (a Microsoft product) is recommended as the editor, with no mention of Linux-preferred alternatives. The 'Get tools' section lists PowerShell (primarily a Windows tool) first, and the Azure CLI installation link for Windows precedes those for Linux and macOS.
Recommendations:
- Alternate the order of tool and installation instructions (e.g., list Azure CLI before PowerShell, or rotate the order of OS-specific installation links).
- Explicitly mention that PowerShell is available cross-platform, or clarify that Bash examples are suitable for Linux/macOS users.
- Recommend additional editors commonly used on Linux (such as Vim, Emacs, or nano) alongside Visual Studio Code.
- Ensure that all sections provide equal visibility to Linux/macOS instructions and tools, not just as secondary options.
- Consider including a short note at the top stating that all instructions are cross-platform unless otherwise noted.
Create pull request
Flagged Code Snippets
Set-AzContext [SubscriptionID/SubscriptionName]
$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource and resource group names"
$resourceGroupName = "${projectName}rg"
New-AzResourceGroup `
-Name $resourceGroupName `
-Location "Central US"
$projectName = Read-Host -Prompt "Enter the same project name"
$templateFile = Read-Host -Prompt "Enter the template file path and file name"
$resourceGroupName = "${projectName}rg"
New-AzResourceGroupDeployment `
-Name DeployLocalTemplate `
-ResourceGroupName $resourceGroupName `
-TemplateFile $templateFile `
-projectName $projectName `
-verbose