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
⚠️
cmd_heavy
⚠️
powershell_examples
⚠️
missing_linux_example
Summary:
The documentation generally aims for cross-platform parity, but there are several subtle Windows biases. In command examples, Windows (Cmd) and PowerShell are often presented before or more prominently than Linux/macOS equivalents. Some sections provide detailed Cmd and PowerShell scripts, while Linux/bash examples are less detailed or missing (e.g., in Java deployment and function invocation). The use of 'command prompt' as a generic term and the inclusion of PowerShell-specific pivots also reinforce a Windows-centric approach. Linux/macOS users may find some steps less clear or less prioritized.
Recommendations:
- Ensure that for every Windows (Cmd or PowerShell) example, an equivalent Linux/macOS (bash/sh) example is provided and given equal prominence.
- When listing multiple platforms, alternate the order or present Linux/macOS first in some sections to avoid always prioritizing Windows.
- Use neutral terms like 'terminal' instead of 'command prompt' when referring to the command line.
- Where PowerShell is used, clarify its cross-platform availability or provide bash alternatives.
- Audit all code snippets and pivots to ensure Linux/macOS users are not missing context or steps (e.g., in Java deployment, ensure bash and Cmd examples are equally detailed).
- Consider a summary table or section that explicitly states cross-platform compatibility and any OS-specific caveats.
Create pull request