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 strives for cross-platform parity, but there are several subtle Windows biases. In command sections, Windows (Cmd) and PowerShell examples are often presented alongside or even before Linux/bash equivalents. Some instructions (such as virtual environment activation for Python) provide more detail for Windows than for Linux/macOS. PowerShell-specific pivots and examples are present, and in some cases, Linux-specific instructions are less prominent or missing (e.g., the use of 'py' instead of 'python3' for venv creation on Windows).
Recommendations:
- Ensure that Linux/macOS examples are always presented with equal prominence and detail as Windows examples, ideally listing Linux/bash first where appropriate.
- Where multiple OS-specific tabs are used, ensure that Linux/bash is the default or at least not always listed after Windows.
- For PowerShell and Cmd examples, always provide bash/zsh equivalents, and clarify when a command is cross-platform.
- In sections like virtual environment creation, clarify the differences between 'py' and 'python3', and ensure Linux users are not left to infer steps.
- Audit for any missing Linux-specific troubleshooting or setup steps (e.g., package installation, file permissions) and add them as needed.
- Where possible, use neutral, cross-platform language such as 'terminal' instead of 'command prompt', and avoid assuming Windows as the default environment.
Create pull request