Bicep Config - Document Details

About This Page

This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.

View on GitHub 📚 View on Microsoft Learn

Bias Analysis

Detected Bias Types

windows_tools

windows_first

missing_linux_example

Summary

The documentation page demonstrates a Windows bias by focusing on Visual Studio Code (a cross-platform editor but with a Windows-centric workflow) and referencing Azure PowerShell and AzureCLI in credential precedence, with PowerShell listed before CLI in examples. There are no explicit Linux or macOS-specific instructions, nor are there examples using Linux-native editors or shell commands for creating or managing the configuration file.

Recommendations

Add explicit examples for creating and editing the bicepconfig.json file using Linux-native tools (e.g., nano, vim, or command-line touch/cat).
When discussing credential precedence, clarify the cross-platform availability of AzureCLI and Azure PowerShell, and consider listing AzureCLI first as it is more commonly used on Linux.
Include screenshots or instructions for creating the configuration file in editors popular on Linux/macOS (e.g., VS Code on Linux, Vim, or even gedit).
Mention that all instructions apply equally to Linux/macOS unless otherwise noted, and provide any OS-specific caveats if they exist.
Ensure that references to tools or commands (such as Visual Studio Code or PowerShell) are balanced with Linux/macOS equivalents or alternatives.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-13 06:17	#107	completed	Clean
2026-01-12 00:00	#99	completed	Clean
2026-01-11 06:20	#98	completed	Clean
2026-01-10 00:00	#92	completed	Clean
2026-01-09 00:00	#87	cancelled	Clean
2026-01-06 22:28	#78	completed	Clean
2025-12-29 18:00	#48	cancelled	Biased
2025-12-15 00:00	#7	completed	Clean
2025-12-14 05:05	#6	completed	Clean

Flagged Code Snippets

{
  "cloud": {
    ...
    "credentialPrecedence": [
      "AzureCLI",
      "AzurePowerShell"
    ]
  },
  "moduleAliases": {
    "ts": {},
    "br": {
      "public": {
        "registry": "mcr.microsoft.com",
        "modulePath": "bicep"
      }
    }
  },
  ...
}

{
  "cloud": {
    "credentialPrecedence": [
      "AzurePowerShell",
      "AzureCLI"
    ]
  },
  "moduleAliases": {
    "br": {
      "ContosoRegistry": {
        "registry": "contosoregistry.azurecr.io"
      },
      "CoreModules": {
        "registry": "contosoregistry.azurecr.io",
        "modulePath": "bicep/modules/core"
      }
    }
  }
}

{
  "cloud": {
    ...
    "credentialPrecedence": [
      "AzurePowerShell",
      "AzureCLI"
    ]
  },
  "moduleAliases": {
    "ts": {},
    "br": {
      "public": {
        "registry": "mcr.microsoft.com",
        "modulePath": "bicep"
      },
      "ContosoRegistry": {
        "registry": "contosoregistry.azurecr.io"
      },
      "CoreModules": {
        "registry": "contosoregistry.azurecr.io",
        "modulePath": "bicep/modules/core"
      }
    }
  },
  ...
}