Sad Tux - Windows bias detected
This page contains Windows bias

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

Detected Bias Types
windows_first
windows_tools
powershell_heavy
missing_linux_example
Summary
The documentation demonstrates some Windows bias, particularly in the Visual Studio Code (VS Code) deployment workflow. Windows-specific steps and tools (such as web.config, Application Insights, and resource group/App Service plan creation) are described in more detail and with more steps than their Linux counterparts. The Windows deployment instructions are more prominent and elaborate, and certain troubleshooting notes (e.g., about web.config) are only mentioned for Windows. There is also a reliance on Visual Studio Code, which is more common on Windows, and some steps reference Windows-centric patterns (e.g., 'right-click', 'Application Settings'). While Linux is supported and examples are present, parity in depth and troubleshooting is lacking. CLI and Portal instructions are more neutral, but the VS Code workflow leans Windows-first.
Recommendations
  • Ensure that Linux deployment instructions are as detailed as Windows, including troubleshooting tips and common issues (e.g., what to do if the app doesn't start, or how to handle environment variables).
  • Provide Linux-specific notes where Windows-specific notes are given (e.g., if web.config is needed for Windows, clarify what Linux expects instead, such as package.json start scripts).
  • Balance the order and prominence of Linux and Windows instructions—avoid always presenting Windows as the 'advanced' or default path.
  • Where possible, use cross-platform terminology and avoid patterns that are only familiar to Windows users (e.g., 'right-click' could be 'context menu').
  • Include explicit Linux troubleshooting sections, especially for common deployment errors.
  • Mention and provide examples for Linux-native tools or workflows (e.g., using nano/vim for editing, or Linux file paths), not just VS Code.
  • Clarify when steps are identical for both OSes, and when they diverge, to help users understand platform-specific requirements.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2026-01-14 00:00 #250 in_progress Clean Clean
2026-01-13 00:00 #246 completed Clean Clean
2026-01-12 00:00 #243 cancelled Clean Clean
2026-01-11 00:00 #240 completed Clean Clean
2026-01-10 00:00 #237 completed Clean Clean
2026-01-09 00:34 #234 completed Clean Clean
2026-01-08 00:53 #231 completed Clean Clean
2026-01-06 18:15 #225 cancelled Clean Clean
2025-09-16 00:00 #113 completed Biased Biased
2025-09-15 00:00 #112 completed Biased Biased
2025-09-14 00:00 #111 completed Clean Clean
2025-09-13 00:00 #110 completed Clean Clean
2025-09-12 00:00 #109 completed Clean Clean
2025-09-11 00:00 #108 completed Clean Clean
2025-09-10 00:00 #107 completed Clean Clean
2025-08-17 00:01 #83 cancelled Biased Biased
2025-07-13 21:37 #48 completed Clean Clean
2025-07-09 13:09 #3 cancelled Clean Clean
2025-07-08 04:23 #2 cancelled Biased Biased

Flagged Code Snippets