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 page demonstrates a subtle Windows bias. While the main focus is on Azure CLI (which is cross-platform), several example variable assignments use PowerShell syntax (e.g., $DiskId = ...), which is not valid in Bash or Linux shells. There are no explicit Bash/Linux shell examples or notes for Linux users. Additionally, in the 'Next steps' section, Azure PowerShell is mentioned before Azure CLI, suggesting a Windows-first approach. There are no Linux-specific instructions or clarifications for cross-platform users.
Recommendations:
- Provide both PowerShell and Bash/Linux shell examples for variable assignments and scripting steps. For example, show both $DiskId=... (PowerShell) and DiskId=... (Bash).
- Add a note clarifying that Azure CLI commands work on Windows, macOS, and Linux, and show how to adapt variable usage for each shell.
- In the 'Next steps' section, list Azure CLI before PowerShell, or present both equally, to avoid Windows-first ordering.
- Explicitly mention that all CLI commands are cross-platform, and provide troubleshooting tips for common shell differences (e.g., file redirection, quoting, environment variables).
- Where referencing scripts or automation, provide sample scripts for both PowerShell and Bash.
Create pull request