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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a Windows-first bias by exclusively referencing the Azure portal (a web GUI) and Azure REST API via Azure Cloud Shell/Bash, but does not provide explicit Linux-native or cross-platform command-line examples outside of the Azure ecosystem. There are no references to PowerShell, but the instructions assume use of the Azure portal (which is platform-agnostic but often associated with Windows workflows) and Azure Cloud Shell (which is available on all platforms but not the same as a local Linux shell). There are no examples for deploying via local Linux shell, nor are there any mentions of Linux-specific tools or workflows.
Recommendations:
- Add explicit instructions and examples for deploying a GeoCatalog resource using the Azure CLI from a local Linux shell, not just via Cloud Shell.
- Clarify that the Azure portal and Azure CLI are cross-platform, and provide guidance for both Windows and Linux users.
- If PowerShell is not required, explicitly state that Bash examples are suitable for Linux/macOS/WSL users.
- Include troubleshooting tips or prerequisites specific to Linux environments (e.g., installing Azure CLI on Ubuntu).
- Ensure screenshots and step-by-step instructions do not assume a Windows environment (e.g., avoid showing Windows-specific UI elements or file paths).
Create pull request