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 demonstrates a Windows bias in the section on retrieving the Azure Maps Client ID programmatically. PowerShell is presented first, with a detailed example using the Get-AzMapsAccount cmdlet, which is specific to Windows environments. The Azure CLI example is provided second, but there are no Linux- or macOS-specific shell examples (e.g., Bash, curl, jq), nor is there mention of cross-platform scripting approaches. The documentation also references Windows-centric tools and patterns (PowerShell) without providing parity for Linux users.
Recommendations:
- Provide Bash (Linux/macOS) shell examples alongside PowerShell, using curl and jq to retrieve the Client ID via the Azure REST API or Azure CLI.
- Present Azure CLI examples before or alongside PowerShell examples, as Azure CLI is cross-platform.
- Explicitly state that both PowerShell and Azure CLI are available on all major platforms, and clarify any platform-specific requirements.
- Avoid assuming the use of Windows tools (such as PowerShell) as the default or primary method.
- Where possible, use cross-platform tools and patterns in code samples to ensure inclusivity for Linux and macOS users.
Create pull request