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
⚠️
windows_tools
Summary:
The documentation demonstrates a mild Windows bias in several areas. While the overall content is cross-platform and Linux is well-supported (especially for hosting), there are multiple instances where Windows terminology, tools, and workflows are mentioned first or exclusively. Specifically, references to 'command prompt', 'Terminal or command prompt', and the recommendation to use remote build when developing on Windows, as well as the use of 'cmd' in folder structure examples, indicate a Windows-centric perspective. There is also a lack of explicit Linux shell (bash) examples or terminology, and no mention of Linux-specific tools or workflows, even though Azure Functions Python hosting is Linux-only.
Recommendations:
- Use neutral or inclusive terminology such as 'terminal' or 'shell' instead of 'command prompt', or mention both (e.g., 'terminal (Linux/macOS) or command prompt (Windows)').
- Provide explicit bash/zsh shell examples alongside or instead of Windows command prompt examples, especially in code blocks and folder structure listings.
- When referencing development environments, list cross-platform options first or in parallel (e.g., 'Terminal (Linux/macOS), Command Prompt or PowerShell (Windows)').
- Clarify that 'cmd' in folder structure listings is for illustration, and provide equivalent bash commands or tree outputs.
- Highlight Linux development workflows and tools (e.g., bash, zsh, Linux package managers) where appropriate, especially since Azure Functions Python apps are hosted on Linux.
- If recommending remote build for Windows users, also provide guidance for Linux/macOS users, and clarify any differences in workflow or recommendations.
- Audit all references to Windows-specific tools (e.g., PowerShell, Command Prompt) and ensure Linux equivalents are mentioned with equal prominence.
Create pull request