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
⚠️
powershell_heavy
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. Windows/command prompt/PowerShell terminology is used first or exclusively in some places, and Windows is sometimes assumed as the local development environment. There is a lack of explicit Linux/macOS terminal examples, and some guidance is worded as if Windows is the default local OS.
Recommendations:
- Provide explicit Linux/macOS terminal/bash examples alongside or before Windows/command prompt/PowerShell examples, especially in sections about local development, publishing, and package management.
- Use neutral terminology such as 'terminal' or 'shell' instead of 'command prompt' when referring to cross-platform command-line usage.
- Clarify instructions that are platform-specific (e.g., file paths, environment variables) and provide both Windows and Linux/macOS variants where relevant.
- In publishing and build guidance, avoid statements like 'Use remote build when you're developing Python apps on Windows' without also addressing Linux/macOS users. Instead, offer guidance for all platforms.
- Where Visual Studio Code is mentioned, also mention other popular cross-platform editors or clarify that VS Code is available on all major OSes.
- Review folder structure and code block language tags (e.g., use 'bash' instead of 'cmd' where appropriate) to ensure parity for Linux/macOS users.
Create pull request