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 PowerShell and Azure CLI examples for most network management tasks, but PowerShell commands are consistently listed before CLI commands. This ordering, along with the use of PowerShell-specific scripting in some examples, subtly prioritizes Windows-centric tooling and patterns, even though Azure CLI is cross-platform and more native to Linux environments. There are no explicit Linux shell (bash) examples, and the documentation does not mention Linux-specific tools or workflows.
Recommendations:
- Alternate the order of PowerShell and Azure CLI examples, or list Azure CLI first to reflect its cross-platform nature and popularity among Linux users.
- Explicitly state that Azure CLI commands work natively on Linux, macOS, and Windows, and provide bash shell examples where appropriate.
- Where PowerShell scripting is used (e.g., looping over NICs), provide equivalent bash/CLI scripts for Linux users.
- Add a note clarifying that all management tasks can be performed from Linux environments using Azure CLI, and link to relevant Linux setup guides.
- Consider including screenshots or walkthroughs using Linux terminals to further demonstrate parity.
Create pull request