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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation page demonstrates a 'Windows-first' bias in several areas: Windows instructions and examples are consistently presented before Linux equivalents, especially in the stack configuration update sections. Some language/platform combinations (e.g., Python on Windows) are explicitly unsupported, but the documentation does not always provide Linux alternatives in those cases. Additionally, the use of Azure portal and Azure CLI is mostly platform-agnostic, but the CLI examples for updating stack versions are more detailed for Windows, and Linux-specific details are sometimes relegated to notes or require extra navigation. There is also an implicit bias in the structure, where Windows is the default or primary path, and Linux is secondary.
Recommendations:
- Present Windows and Linux instructions/examples in parallel or with equal prominence, rather than always listing Windows first.
- Where a language/platform combination is unsupported (e.g., Python on Windows), provide a direct Linux example or link, rather than just instructing the user to switch tabs.
- Ensure that CLI examples for Linux are as detailed and explicit as those for Windows, including full command examples for all supported languages.
- Where limitations exist (e.g., Linux Consumption plan restrictions), provide clear alternative steps or workarounds for Linux users.
- Consider a structure where the user selects their OS first, then sees language-specific instructions, to avoid implicit prioritization of Windows.
Create pull request
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"