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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation frequently presents Windows instructions and examples before Linux equivalents, and in some cases, Linux instructions are less detailed or have additional restrictions. There are also sections where only Windows-specific tools or paths are referenced, and Linux users are sometimes redirected or given less guidance.
Recommendations:
- Ensure that Linux instructions and examples are presented alongside Windows, or in parallel, rather than after or as an afterthought.
- Provide equally detailed Linux examples for all languages and scenarios, including local development and configuration steps.
- Avoid language such as 'select the Windows tab' as the default; instead, present both OS options equally.
- Where features are not available on Linux (e.g., Python on Windows), clearly explain alternatives or workarounds for Linux users.
- Review all code samples and ensure that Linux command-line and file path conventions are included where relevant.
- Where possible, use cross-platform tools and instructions (such as Azure CLI) as the primary example, and only provide OS-specific guidance when necessary.
Create pull request