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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. PowerShell examples are consistently presented before Azure CLI examples, and PowerShell is referenced as a primary management tool throughout. There is no mention of Linux-specific shell usage or examples, and the CLI examples, while cross-platform, are not explicitly shown in a Linux/bash context. Additionally, some CLI example descriptions mistakenly refer to 'Azure PowerShell command' instead of 'Azure CLI command', reinforcing the Windows-centric perspective.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or present Azure CLI (which is cross-platform) first to better serve Linux users.
- Explicitly mention that Azure CLI commands can be run in Bash (Linux/macOS) and provide sample commands in bash syntax (e.g., with export statements, bash variables).
- Correct any mislabeling of CLI examples as 'Azure PowerShell command' to avoid confusion.
- Where possible, include notes or examples for Linux/macOS users, such as using bash variables instead of PowerShell variables.
- Add a section or note about installing and using Azure CLI on Linux/macOS, and clarify that PowerShell is optional for management tasks.
- Ensure screenshots and output samples are not exclusively from Windows environments (e.g., avoid showing only PowerShell output).
Create pull request