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
⚠️
missing_linux_example
Summary:
The documentation demonstrates a moderate Windows bias. Windows-specific tools, settings, and instructions are often mentioned before or more prominently than their Linux equivalents. Some sections provide only Windows-oriented examples (e.g., ReadyToRun, checking 32/64-bit status), or use Windows-centric terminology and commands. While Linux is mentioned and supported, parity in examples and guidance is inconsistent, and some Linux-specific details are relegated to secondary tabs or footnotes.
Recommendations:
- Ensure all CLI and configuration examples are provided for both Windows and Linux, with equal prominence and detail.
- When referencing tools (e.g., Azure CLI, PowerShell), always provide both Windows and Linux command variants, or clarify cross-platform compatibility.
- Avoid listing Windows methods or tools first by default; alternate order or present both together.
- Expand ReadyToRun and deployment sections to include explicit Linux examples (e.g., dotnet publish --runtime linux-x64, project file snippets for Linux).
- Where tabs are used for OS-specific instructions, ensure both tabs are equally detailed and easy to find.
- Explicitly mention any differences or limitations for Linux users up front, rather than as footnotes.
- Audit for any references to Visual Studio or PowerShell that lack corresponding VS Code or Bash/Linux alternatives, and add them where missing.
Create pull request