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
⚠️
windows_tools
Summary:
The documentation is generally cross-platform and Linux-focused for hosting, but there are subtle Windows biases in the development and publishing workflow sections. Specifically, Windows is mentioned first or as the default in several places (e.g., 'command prompt', 'developing on Windows', 'use remote build when developing Python apps on Windows'), and there is a lack of explicit Linux shell examples (e.g., bash/zsh) in command snippets. The term 'command prompt' is ambiguous and can be interpreted as Windows-centric. Visual Studio Code is referenced as a primary tool, which is cross-platform, but no mention is made of Linux-specific editors or shell environments. The documentation does not provide PowerShell-specific examples, but the ordering and language suggest a slight preference for Windows development environments.
Recommendations:
- Replace ambiguous terms like 'command prompt' with 'terminal (Bash, zsh, or Command Prompt)' and provide explicit bash/zsh examples alongside any Windows-specific instructions.
- When mentioning development environments, list Linux terminals and shells (e.g., Bash, zsh) before or alongside Windows Command Prompt to avoid 'windows_first' bias.
- In publishing and build workflow sections, clarify that both Windows and Linux are supported for local development and publishing, and provide shell-agnostic or dual examples (e.g., both bash and cmd).
- Highlight Linux-native editors (e.g., Vim, Emacs, GNOME Terminal) as alternatives to Visual Studio Code, or at least acknowledge their use.
- Where remote build is recommended for Windows, also provide guidance for Linux users, ensuring parity in workflow descriptions.
- Audit all command snippets to ensure they are not Windows-centric (e.g., avoid using only .cmd file extensions or Windows path separators).
Create pull request