Document Details

Functions Infrastructure As Code
Home / Scan #41 / Functions Infrastructure As Code
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.
GitHub View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Windows and Linux examples for most ARM/Bicep template scenarios, and covers Linux-specific hosting plans (e.g., Flex Consumption, Container Apps, Azure Arc) in detail. However, there is a consistent pattern of presenting Windows examples and terminology before Linux equivalents, especially in code tabs and explanatory text. Additionally, the only explicit command-line deployment examples outside of Azure CLI are for PowerShell, with no Bash or cross-platform shell equivalents provided. Some references to tools (e.g., Visual Studio Code extensions) are cross-platform, but the deployment section is PowerShell-centric.
Recommendations
  • Alternate the order of Windows and Linux examples/tabs, or present Linux first where it is the default or recommended platform.
  • Provide Bash or cross-platform shell equivalents for all PowerShell deployment examples, especially for template deployment and resource group creation.
  • Explicitly mention that all ARM/Bicep templates and Azure CLI commands are cross-platform, and provide sample commands for both Windows and Linux environments.
  • Where possible, use neutral language (e.g., 'on your system' instead of 'on Windows') unless the content is truly OS-specific.
  • Highlight Linux-specific considerations or best practices earlier in the document, not only as addenda to Windows instructions.
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

### [Visual Studio Code](#tab/vs-code)

In [Visual Studio Code](https://code.visualstudio.com/), install the latest [Bicep extension](https://marketplace.visualstudio.com/items?itemName=ms-azuretools.vscode-bicep) or [Azure Resource Manager Tools extension](https://marketplace.visualstudio.com/items?itemName=msazurermtools.azurerm-vscode-tools).

These extensions report syntactic errors in your code before deployment. For some examples of errors, see the [Fix validation error](../azure-resource-manager/troubleshooting/quickstart-troubleshoot-arm-deployment.md#fix-validation-error) section of the troubleshooting article.

---

You can also create a test resource group to find [preflight](../azure-resource-manager/troubleshooting/quickstart-troubleshoot-arm-deployment.md?tabs=azure-cli#fix-preflight-error) and [deployment](../azure-resource-manager/troubleshooting/quickstart-troubleshoot-arm-deployment.md?tabs=azure-cli#fix-deployment-error) errors.

## Deploy your template

You can use any of the following ways to deploy your Bicep file and template:

### [Bicep](#tab/bicep)

- [Azure CLI](../azure-resource-manager/bicep/deploy-cli.md)
- [PowerShell](../azure-resource-manager/bicep/deploy-powershell.md)

### [ARM template](#tab/json)

- [Azure portal](../azure-resource-manager/templates/deploy-portal.md)
- [Azure CLI](../azure-resource-manager/templates/deploy-cli.md)
- [PowerShell](../azure-resource-manager/templates/deploy-powershell.md)

---

### Deploy to Azure button

> [!NOTE]
> This method doesn't support deploying Bicep files currently.

Replace 
# Register Resource Providers if they're not already registered
Register-AzResourceProvider -ProviderNamespace "microsoft.web"
Register-AzResourceProvider -ProviderNamespace "microsoft.storage"

# Create a resource group for the function app
New-AzResourceGroup -Name "MyResourceGroup" -Location 'West Europe'

# Deploy the template
New-AzResourceGroupDeployment -ResourceGroupName "MyResourceGroup" -TemplateFile main.bicep  -Verbose

# Register Resource Providers if they're not already registered
Register-AzResourceProvider -ProviderNamespace "microsoft.web"
Register-AzResourceProvider -ProviderNamespace "microsoft.storage"

# Create a resource group for the function app
New-AzResourceGroup -Name "MyResourceGroup" -Location 'West Europe'

# Deploy the template
New-AzResourceGroupDeployment -ResourceGroupName "MyResourceGroup" -TemplateFile azuredeploy.json  -Verbose