Document Details

Update Language Versions
Home / Scan 41 / Update Language Versions
❌
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Bias Types:
⚠️ windows_first
⚠️ missing_linux_example
⚠️ windows_tools
Summary:
The documentation page demonstrates a Windows-first bias in several areas: Windows/Azure portal instructions and examples are consistently presented before Linux equivalents, and in some cases, Linux instructions are only available for certain plans or are less detailed. Some language stacks (e.g., Python) are explicitly unsupported on Windows, but the documentation still defaults to Windows tabs. There is also a lack of parity in example commands and guidance for Linux users, especially regarding portal-based updates and plan limitations.
Recommendations:
  • Present Windows and Linux instructions side-by-side or in parallel tabs, rather than always leading with Windows.
  • Ensure that all examples and step-by-step instructions are available for both Windows and Linux, including portal-based and CLI-based workflows.
  • Clearly indicate plan limitations for both OSes at the start of relevant sections, not only in Linux-specific notes.
  • Where a feature is unsupported on one OS (e.g., Python on Windows), default the documentation tab to the supported OS, or provide a clear redirect.
  • Provide equivalent depth and detail for Linux workflows, including screenshots and portal navigation, where possible.
  • Avoid assuming Windows as the default environment in language or structure; use neutral phrasing such as 'On Windows' and 'On Linux' equally.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean

Flagged Code Snippets

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"
az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table
az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"
az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"