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
Summary:
The documentation page demonstrates a Windows bias by providing only PowerShell commands for gateway configuration, explicitly instructing users to use PowerShell for certain steps, and omitting equivalent instructions for Linux users (such as Azure CLI or Bash). There are no Linux or cross-platform command-line examples, and the PowerShell approach is presented as the default or only supported method for some tasks.
Recommendations:
- Provide Azure CLI (az) command examples alongside PowerShell for all configuration steps, especially for gateway management.
- Clearly indicate when a step can be performed using the Azure CLI or Bash on Linux/macOS, and provide those instructions.
- If certain features are only available via PowerShell, explicitly state this limitation and provide guidance for Linux users (e.g., using Azure Cloud Shell, which supports both PowerShell and Bash).
- Review the documentation to ensure that tool-agnostic or cross-platform approaches are presented first, or at least in parallel with Windows-specific instructions.
- Add a section or note summarizing cross-platform support and linking to relevant Azure CLI documentation.
Create pull request