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 PowerShell examples for policy creation and assignment, but PowerShell (a Windows-centric tool) is given equal or greater prominence, including full command blocks and parameter explanations. There are no explicit Linux shell (bash) examples, and PowerShell is referenced as a primary method for retrieving resource IDs and performing assignments. This may create a perception of Windows/PowerShell preference, especially for users on Linux or macOS.
Recommendations:
- Add explicit bash shell examples for all Azure CLI commands, demonstrating usage in a Linux environment.
- Clarify that Azure CLI commands are cross-platform and can be run in bash, zsh, or other Linux shells, not just Windows Command Prompt or PowerShell.
- Where PowerShell is used to retrieve resource IDs or manipulate output, provide equivalent bash/CLI pipelines (e.g., using jq or grep/awk) for Linux users.
- Consider reordering examples to present Azure CLI (which is cross-platform) before PowerShell, or clearly label both as equally supported.
- Add a brief section or note highlighting that all operations can be performed from Linux/macOS using Azure CLI, and link to relevant setup guides.
Create pull request