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 (such as 'py -m venv .venv' and '.venv\Scripts\Activate.ps1') are listed before their Linux equivalents. The file path separator in the memory profiler output example also uses Windows-style backslashes. However, Linux alternatives are present, and there are no exclusive Windows-only tools or missing Linux examples.
Recommendations:
- Present Linux and Windows instructions in parallel (side-by-side tabs or clearly separated steps) rather than listing Windows first.
- Use neutral or platform-agnostic language, e.g., 'Open a terminal' instead of 'Open a Windows PowerShell or any Linux shell as you prefer.'
- When showing commands, either provide both Windows and Linux/Mac commands together, or use tabs for each OS.
- In code or output examples, use platform-neutral paths (e.g., <ProjectRoot>/HttpTriggerAsync/__init__.py) or show both Windows and Linux path formats.
- Ensure that all steps and tooling are equally accessible and clear for Linux users, not just as an afterthought.
Create pull request