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 presents configuration options in the order: Azure portal, Azure PowerShell, and then Azure CLI. The PowerShell section is more detailed, with extensive example scripts and a dedicated cmdlet reference, while the Azure CLI section is less detailed and lacks a similar command reference. There are no Linux-specific shell examples (e.g., Bash), and the CLI examples are not explicitly shown in a Linux context. There is no mention of Linux tools or workflows, and the documentation implicitly assumes familiarity with Windows-centric tools (PowerShell) by providing them before CLI.
Recommendations:
- Present Azure CLI examples before PowerShell, or provide both in parallel tabs to avoid implying a Windows-first workflow.
- Expand the Azure CLI section to include a comprehensive command reference similar to the PowerShell cmdlet reference.
- Add explicit Bash/Linux shell examples or notes clarifying that Azure CLI commands work cross-platform, including on Linux and macOS.
- Where possible, mention that Azure CLI is the recommended cross-platform tool for scripting and automation, especially for Linux users.
- Ensure parity in detail and troubleshooting notes between PowerShell and CLI sections.
Create pull request