Document Details

How To Create Configure Projects
Home / Scan #41 / How To Create Configure Projects
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
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by using PowerShell-style variable assignment (e.g., $VAR = ...) and line continuation (backtick `), which are not compatible with Linux/macOS shells. All CLI examples assume a Windows/PowerShell environment, with no equivalent Bash or cross-platform examples provided. This may confuse or hinder Linux/macOS users attempting to follow the guide.
Recommendations
  • Provide parallel Bash (Linux/macOS) examples for all CLI commands, using appropriate syntax (e.g., VAR=..., line continuation with \).
  • Clearly indicate which examples are for PowerShell/Windows and which are for Bash/Linux/macOS.
  • Consider using cross-platform compatible syntax where possible, or at least link to a section explaining the differences.
  • Add a note at the top of the page clarifying the shell environment assumed, and direct users to the appropriate examples for their OS.
  • Avoid using Windows-specific command constructs (like Write-Output, backtick for line continuation) without Linux equivalents.
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

    $DEVCID = az devcenter admin devcenter show -n <devcenterName> --query id -o tsv
    Write-Output $DEVCID
    
    az devcenter admin project create -n <projectName> `
    --description "My first project." `
    --dev-center-id $DEVCID
    
    $SUBID = az account show --name <subscriptionName> --query id -o tsv
    Write-Output $SUBID
    
    $OID = az ad sp list --display-name <devcenterName> --query [].id -o tsv
    Write-Output $OID
    
    az role assignment create --assignee $OID `
    --role "Owner" `
    --scope "/subscriptions/$SUBID"
    
    az role assignment create --assignee $MYOID `
    --role "Deployment Environments User" `
    --scope "/subscriptions/$SUBID"
    
    # Remove the group default scope for next the command. 
    az configure --defaults group=

    $ROID = az role definition list -n "Owner" --scope /subscriptions/$SUBID --query [].name -o tsv
    Write-Output $ROID

    # Set the default resource group again.
    az configure --defaults group=<resourceGroupName>
    
    $roles = "{`"$($ROID)`":{}}"
    az devcenter admin project-environment-type create `
        -n <availableEnvironmentType> `
        --project <projectName> `
        --identity-type "SystemAssigned" `
        --roles $roles `
        --deployment-target-id "/subscriptions/$SUBID" `
        --status Enabled
    
    $MYOID = az ad signed-in-user show --query id -o tsv
    Write-Output $MYOID
    
    az role assignment create --assignee $MYOID `
    --role "DevCenter Project Admin" `
    --scope "/subscriptions/$SUBID"