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
โ ๏ธ
powershell_heavy
Summary:
The documentation demonstrates a mild Windows bias, particularly in the local development instructions. Windows PowerShell is mentioned first, and Windows-specific commands and paths are presented before their Linux equivalents. The use of 'py -m venv' (Windows) is shown before 'python3 -m venv' (Linux), and the activation command for PowerShell is listed before the Linux shell equivalent. However, Linux alternatives are present, and the documentation does not omit Linux instructions entirely.
Recommendations:
- Present Windows and Linux instructions in parallel or in a tabbed format, rather than listing Windows first.
- Use neutral language such as 'In Windows PowerShell, run: ... In Linux shell, run: ...' or provide both commands together.
- Where file paths are shown (e.g., <ProjectRoot>\HttpTriggerAsync\__init__.py), also show the Linux path (<ProjectRoot>/HttpTriggerAsync/__init__.py).
- Avoid phrases like 'Open a Windows PowerShell or any Linux shell as you prefer'โinstead, use 'Open a terminal (Windows PowerShell or Linux shell)'.
- Ensure that all examples, screenshots, and outputs are shown for both platforms where differences exist.
Create pull request