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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a mild Windows bias. Windows-specific tools and configuration steps are often mentioned before their Linux equivalents, and some CLI examples are Windows-centric. While Linux is supported and mentioned, Linux-specific instructions are sometimes less detailed or appear after Windows instructions. In some cases, Linux examples or notes are missing or less prominent, especially for command-line and deployment scenarios.
Recommendations:
- Ensure all CLI and deployment examples are provided for both Windows and Linux, with equal prominence and detail.
- When listing tools or configuration steps (e.g., Azure CLI, PowerShell), present Linux and Windows options side by side or in parallel tabs, rather than listing Windows first.
- Include explicit Linux shell examples (bash/zsh) for all command-line operations, not just Azure CLI commands.
- For sections referencing Visual Studio or Windows-specific tooling, add equivalent instructions for Linux-friendly tools such as VS Code, .NET CLI, and Azure CLI.
- Review all references to configuration settings (e.g., environment variables, file paths) to ensure Linux-specific guidance is included and not just assumed.
- Where possible, avoid language that implies Windows is the default or primary platform; instead, use neutral or cross-platform phrasing.
Create pull request