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_tools
powershell_heavy
missing_linux_example
Summary
The documentation provides both Azure CLI and PowerShell examples throughout, but for PowerShell users it exclusively recommends and demonstrates the use of ARMClient (armclient.exe), a Windows-centric tool, for making REST API calls. There is no mention of Linux-native alternatives (such as curl or httpie), nor are there Bash or shell script examples for REST calls outside of Azure CLI. This creates a Windows bias by assuming PowerShell/ARMClient as the default non-CLI workflow and omitting Linux-friendly REST tooling.
Recommendations
  • For REST API examples, provide Linux-native alternatives using curl or httpie alongside or instead of ARMClient in the PowerShell sections.
  • Explicitly mention that ARMClient is primarily a Windows tool, and suggest cross-platform alternatives for Linux/macOS users.
  • Where PowerShell is used for scripting, consider providing equivalent Bash/shell script examples for Linux users.
  • In the prerequisites, mention Linux-compatible tools for REST operations, not just ARMClient.
  • Ensure that all command-line examples are tested and presented in a cross-platform way, clarifying any OS-specific requirements.
GitHub Create Pull Request

Scan History

Date Scan Status Result
2025-07-12 23:44 #41 cancelled Biased Biased
2025-07-12 00:58 #8 cancelled Clean Clean
2025-07-10 05:06 #7 processing Clean Clean

Flagged Code Snippets

# [PowerShell](#tab/azure-powershell)

This example prompts you to enter a resource group, location, and provider's function app name. The names are stored in variables that are used in other commands. The [New-AzResourceGroup](/powershell/module/az.resources/new-azresourcegroup) and [New-AzResourceGroupDeployment](/powershell/module/az.resources/new-azresourcegroupdeployment) commands deploy the resources.

# [PowerShell](#tab/azure-powershell)

# [PowerShell](#tab/azure-powershell)

---

## Use PUT to create resource

In this quickstart, the template used the resource type `Microsoft.CustomProviders/resourceProviders/users` to deploy a resource. You can also use a `PUT` operation to create a resource. For example, if a resource isn't deployed with the template, the `PUT` operation will create a resource.

In this example, because the template already deployed a resource, the `PUT` operation creates a new resource.

# [PowerShell](#tab/azure-powershell)

# [PowerShell](#tab/azure-powershell)