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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a Windows bias by providing only Azure PowerShell command-line examples for scripting and automation, without any equivalent Azure CLI (cross-platform) or Bash examples. PowerShell is a Windows-native tool (though now cross-platform, but still Windows-centric in Azure docs), and its installation instructions and usage are emphasized. There are no Linux- or macOS-specific instructions, nor are there any Bash or Azure CLI examples, which are more common on Linux systems. The order of presentation also places PowerShell before ARM templates, and there is no mention of cross-platform scripting approaches.
Recommendations:
- Add equivalent Azure CLI (az) command examples for all PowerShell scripts, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Include Bash script examples where appropriate, especially for resource creation and management.
- Explicitly mention that the steps are cross-platform where possible, and clarify any OS-specific requirements.
- Consider presenting Azure CLI examples before or alongside PowerShell to avoid the impression of Windows-first bias.
- Add a section or note for Linux/macOS users, including any prerequisites or differences in experience.
- Review links and references to ensure they are not PowerShell-exclusive (e.g., link to both PowerShell and CLI guides).
Create pull request