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
Summary:
The documentation consistently presents PowerShell (a Windows-centric tool) examples alongside Azure CLI, often listing PowerShell before CLI in explanations and code samples. There is a strong focus on PowerShell-specific switches, parameters, and output handling, with detailed PowerShell scripting shown. No explicit Linux shell (bash) or cross-platform scripting examples are provided beyond Azure CLI, and PowerShell is treated as a primary interface. The documentation assumes familiarity with PowerShell cmdlets and patterns, which may disadvantage Linux/macOS users who do not use PowerShell.
Recommendations:
- Ensure Azure CLI examples are always presented first, as it is natively cross-platform and more familiar to Linux/macOS users.
- Where PowerShell scripting is shown, provide equivalent bash scripting examples for common tasks (e.g., looping over results, variable assignment).
- Clarify that PowerShell Core is available cross-platform, but also provide bash/zsh examples for Linux/macOS users.
- Avoid using Windows-specific terminology (e.g., 'module', 'cmdlet') without explanation or Linux equivalents.
- Explicitly mention that all Azure CLI commands work identically on Linux, macOS, and Windows, and highlight any OS-specific considerations.
- Add a section or callout for Linux/macOS users, linking to relevant shell scripting resources or Azure CLI documentation.
Create pull request