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
⚠️
windows_tools
Summary:
The documentation provides extensive Azure PowerShell examples and references, often giving them equal or greater prominence than Azure CLI. PowerShell is a Windows-centric tool, and its heavy use can signal a Windows bias. Additionally, there are no explicit Linux shell (bash) or platform-agnostic scripting examples, and no mention of Linux-specific tools or workflows. The documentation does not clarify cross-platform compatibility for PowerShell commands, which may lead Linux users to assume these instructions are Windows-only.
Recommendations:
- Include explicit bash (Linux shell) examples alongside PowerShell, especially for scripting and token retrieval.
- Clarify that Azure CLI and PowerShell are both cross-platform, and indicate which commands work on Linux, macOS, and Windows.
- When listing tabs or options, consider ordering Azure CLI before PowerShell to reflect its broader cross-platform usage.
- Add notes or links to installing and using Azure PowerShell on Linux/macOS, or recommend Azure CLI as the default for non-Windows users.
- Where PowerShell is not supported (e.g., adding user-assigned identity in App Service), suggest alternative Linux-friendly approaches.
- Ensure that all code samples and instructions are tested and clearly marked as cross-platform where applicable.
Create pull request