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 does not show overt Windows or PowerShell bias in terms of explicit command-line examples, but it does exhibit 'windows_first' and 'missing_linux_example' bias in a few subtle ways. For example, the only command-line example for checking the current primary region uses the 'ping' command, which is available on both Windows and Linux, but the documentation does not clarify this cross-platform applicability or provide Linux-specific context. Additionally, all screenshots and portal instructions are platform-agnostic, but the sample code references only .NET (commonly associated with Windows), and there are no explicit Linux or cross-platform SDK/sample references. There are no PowerShell-specific or Windows tool-specific instructions, but the lack of explicit Linux parity in examples and sample references is a form of bias.
Recommendations:
- When providing command-line instructions (e.g., 'ping'), clarify that the command works on both Windows and Linux, or provide equivalent Linux shell commands if differences exist.
- Include sample references or code snippets in languages and SDKs commonly used on Linux (e.g., Python, Java, Node.js), not just .NET.
- If referencing the Azure CLI, note that it is cross-platform and provide any necessary shell syntax for both Windows (cmd/PowerShell) and Linux/macOS (bash/zsh).
- Add explicit statements or sections confirming that all features and management tasks are supported equally on Linux and Windows, especially for automation and scripting.
- Where screenshots are used, consider including at least one from a Linux environment or clarify that the portal experience is identical across platforms.
Create pull request