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

Bias Types:
⚠️ windows_first
⚠️ powershell_heavy
⚠️ windows_tools
⚠️ missing_linux_example
Summary:
The documentation shows some Windows bias, particularly in the Java section where command examples are presented for Bash, PowerShell, and Cmd, with PowerShell and Cmd (Windows shells) given equal prominence to Bash (Linux/macOS). The Java Maven archetype instructions list Bash first, but Windows shells are not clearly deprioritized. There are also references to Windows-style paths (e.g., '\src\main\java\com\fabrikam'), and the use of 'command prompt' terminology, which is more common in Windows contexts. While most CLI examples are cross-platform, the documentation does not always clarify Linux-specific nuances, and some steps (like stopping the function host) use Windows-centric key combinations (Ctrl+C and 'choose y'), which may differ on Linux. There are no explicit Linux-only examples or troubleshooting tips, and some tools (like jq) are mentioned as available in Azure Cloud Shell but not directly addressed for local Linux environments.
Recommendations:
  • For every example that lists PowerShell or Cmd, ensure Bash or sh is listed first and clearly marked as the default for Linux/macOS users.
  • When referencing file paths, use POSIX-style paths (forward slashes) or provide both Windows and Linux/macOS path formats.
  • Avoid using 'command prompt' as a generic term; instead, use 'terminal' or specify 'Windows Command Prompt' when appropriate.
  • Provide explicit Linux/macOS troubleshooting notes where behaviors may differ (e.g., process termination, permissions, environment variables).
  • Clarify installation and usage of tools like jq for Linux users, not just in the context of Azure Cloud Shell.
  • Include a section or callouts for common Linux/macOS issues or tips, such as case sensitivity, shell differences, or required dependencies.
  • Ensure that all scripts and code snippets are tested and work as-is on both Windows and Linux/macOS platforms.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-23 00:00 #89 in_progress ❌ Biased
2025-08-22 00:01 #88 completed ❌ Biased
2025-08-21 00:01 #87 in_progress ❌ Biased
2025-08-20 00:01 #86 completed ❌ Biased
2025-08-19 00:01 #85 completed ❌ Biased
2025-08-18 00:00 #84 in_progress ❌ Biased
2025-08-17 00:01 #83 in_progress ✅ Clean
2025-08-12 00:00 #78 in_progress ✅ Clean
2025-07-24 00:00 #59 completed ✅ Clean
2025-07-15 00:00 #51 completed ❌ Biased

Flagged Code Snippets