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
Summary:
The documentation provides both Azure CLI and PowerShell examples for all programmatic tasks, but PowerShell is given equal or greater prominence, including in advanced scenarios and inline code blocks. PowerShell is a Windows-centric tool, and its inclusion as a primary example can be seen as a Windows bias, especially since Linux-native scripting options (such as Bash or shell scripts) are not explicitly mentioned. Additionally, in some advanced scenario sections, PowerShell examples are shown before or without equivalent CLI examples, reinforcing a 'windows_first' pattern.
Recommendations:
- Ensure that for every PowerShell example, an equivalent Azure CLI example is provided, especially in advanced scenario sections (e.g., multi-source rules, Azure Front Door filtering).
- Where possible, provide Bash/shell script snippets for common Linux workflows, or clarify that Azure CLI commands can be run natively on Linux/macOS.
- In introductory and advanced sections, present Azure CLI examples before PowerShell, as Azure CLI is cross-platform and more native to Linux environments.
- Explicitly state that all Azure CLI commands work on Linux, macOS, and Windows, and consider linking to guidance on installing and using Azure CLI on Linux.
- Avoid assuming the use of PowerShell in narrative text; instead, refer to 'your preferred scripting environment' or similar inclusive language.
Create pull request