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
⚠️
missing_linux_example
Summary:
The documentation is heavily biased towards Windows and PowerShell users. All command-line examples use PowerShell syntax (e.g., variable assignment with $ and $(...)), and the text explicitly states 'we're using PowerShell' without providing equivalent Bash/Linux shell examples. There is no mention of Linux, macOS, or cross-platform shell usage, which may hinder accessibility for non-Windows users.
Recommendations:
- Provide parallel Bash/Linux shell examples for all command-line steps, using standard Bash variable syntax and command substitution.
- Clarify that Azure CLI is cross-platform and can be used in any shell, not just PowerShell.
- Avoid language like 'we're using PowerShell' unless alternatives are also presented; instead, state that examples are provided for both PowerShell and Bash.
- Add a section or callout for macOS/Linux users, ensuring parity in instructions and troubleshooting.
- Where possible, use shell-agnostic Azure CLI commands without shell-specific variable assignment, or show both approaches.
Create pull request
Flagged Code Snippets
$ResourceGroup = "<resource_group>"
$UserId = $(az ad signed-in-user show --query id -o tsv)
az role assignment create --role "Storage Blob Data Contributor" --assignee $UserId --scope $StorageAccountId
$DocumentContent = "The patient came in for a visit on 10/12/2023 and was seen again November 4th at Contoso Hospital."
az storage blob upload --data $DocumentContent --account-name $StorageAccountName --container-name deidtest --name deidsample.txt --auth-mode login