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
⚠️
windows_tools
Summary:
The documentation presents both Azure CLI and Azure PowerShell examples for all commands, but it exhibits a Windows bias by consistently including PowerShell (a Windows-centric tool) as a primary example, mentioning Visual Studio (a Windows-first IDE) before cross-platform alternatives, and omitting explicit Linux/macOS shell (bash/zsh) examples. There are no bash or shell script equivalents, and the guidance assumes the use of Visual Studio Code or Visual Studio, both of which are more common on Windows. The lack of Linux-specific instructions or troubleshooting further reinforces the Windows-centric approach.
Recommendations:
- Add bash/zsh shell script examples alongside PowerShell, especially for variable assignment and command invocation.
- Explicitly mention that Azure CLI commands work cross-platform and provide Linux/macOS-specific notes where file paths or environment setup may differ.
- Include setup and usage instructions for common Linux editors (e.g., Vim, nano) or cross-platform editors (e.g., VS Code) before or alongside Visual Studio.
- Ensure that all prerequisite and installation steps include Linux/macOS guidance (e.g., package manager commands for Bicep CLI and Azure CLI).
- Where PowerShell is referenced, clarify that it is available cross-platform, but provide native shell alternatives for Linux/macOS users.
Create pull request
Flagged Code Snippets
Get-AzContainerRegistry -ResourceGroupName "<resource-group-name>" -Name "<registry-name>" | Select-Object LoginServer
Publish-AzBicepModule -FilePath ./storage.bicep -Target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 -DocumentationUri https://www.contoso.com/exampleregistry.html
Get-AzContainerRegistryRepository -RegistryName <registry-name>
$resourceGroupName = "{provide-a-resource-group-name}"
$templateFile = "{provide-the-path-to-the-bicep-file}"
New-AzResourceGroup -Name $resourceGroupName -Location eastus
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateFile $templateFile
$resourceGroupName = "{provide-the-resource-group-name}"
Remove-AzResourceGroup -Name $resourceGroupName