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 examples for command-line operations, with no mention of Azure CLI or Bash scripting alternatives that are cross-platform and commonly used on Linux and macOS. Windows tools and patterns (such as PowerShell and its cmdlets) are mentioned exclusively and before any cross-platform alternatives. There are no Linux-specific or cross-platform command-line instructions, and the documentation does not acknowledge or guide users on how to perform these tasks outside of the Windows/PowerShell ecosystem.
Recommendations:
- Add equivalent Azure CLI examples (az apim ...) alongside or before PowerShell examples for all operations, as Azure CLI is cross-platform and widely used on Linux and macOS.
- Explicitly mention that both Azure PowerShell and Azure CLI can be used, and provide guidance for users on different operating systems.
- Include Bash scripting examples where appropriate, especially for automation scenarios.
- Where PowerShell is referenced, clarify its availability on Linux and macOS, or provide links to installation instructions for non-Windows platforms.
- Review and update the documentation structure to avoid always presenting Windows/PowerShell first; consider leading with cross-platform tools or presenting them in parallel.
- Ensure that all screenshots and UI references are not specific to Windows-only environments.
Create pull request