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 by providing only Azure PowerShell examples for command-line operations, with no mention of Azure CLI (which is cross-platform and commonly used on Linux/macOS). The PowerShell sections are prominent and detailed, while Linux-native tools or workflows are not addressed. Instructions for installing or using PowerShell are given, but there is no equivalent guidance for Linux users. The documentation implicitly assumes a Windows environment for scripting and automation.
Recommendations:
- Add equivalent Azure CLI examples alongside all Azure PowerShell examples, especially for creating and managing managed identities and API Management instances.
- Include installation and usage instructions for Azure CLI, and clarify that it is cross-platform (Windows, Linux, macOS).
- Where PowerShell is referenced, add a note or section for Bash/shell users, highlighting any differences or considerations.
- Ensure that all automation and scripting instructions are provided for both PowerShell and Bash/CLI environments.
- Review and update screenshots or UI references to ensure they are not Windows-specific if possible.
- Explicitly mention cross-platform support and recommend tools that work equally well on Linux, macOS, and Windows.
Create pull request