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
Summary:
The documentation provides both Azure CLI and Azure PowerShell examples for verifying results, but consistently lists Azure CLI (which is cross-platform) before Azure PowerShell. However, the PowerShell section uses Windows-style variable assignment syntax (with $), which may be confusing for Linux/macOS users. There are no explicit Linux-specific instructions, but the use of Azure CLI as the primary example helps maintain some parity. No Windows-only tools or patterns are mentioned, but the presence of PowerShell examples and syntax could be seen as a subtle Windows bias.
Recommendations:
- Clarify that Azure CLI commands work on Windows, Linux, and macOS, and recommend it as the default for cross-platform users.
- Explicitly state that PowerShell Core is available on Linux/macOS if PowerShell examples are included, or clarify that the PowerShell examples are for users who prefer that shell.
- Consider adding a Bash shell tab or section for variable assignment and command usage to make Linux/macOS users feel more directly supported.
- If possible, avoid Windows-specific syntax in variable assignments in the PowerShell section, or provide equivalent Bash examples.
- In the prerequisites, mention that all steps work on Windows, Linux, and macOS, and link to installation instructions for each platform.
Create pull request