Deploy Control Plane - 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

missing_windows_example

linux_first

linux_only

windows_tools

Summary

The documentation demonstrates a bias toward Linux environments. All core deployment instructions and scripts are provided exclusively for Linux, with explicit statements that Windows cannot be used for control plane deployment. Windows-specific instructions are only present for optional or peripheral tasks (such as preparing the web app), and even then, the main deployment workflow is not supported on Windows. Linux examples are always presented first and in detail, while Windows is either omitted or explicitly unsupported.

Recommendations

Provide equivalent PowerShell or Windows Command Prompt scripts for all deployment steps where possible.
If Windows is not supported for certain operations, explain the technical reasons and suggest workarounds (e.g., using WSL, Docker, or Azure Cloud Shell).
Ensure that any scripts or automation tools are cross-platform or document their platform requirements clearly at the beginning.
For tasks that can be performed on both platforms (such as preparing the web app), ensure parity in the depth and clarity of examples.
Consider providing guidance for using WSL on Windows as an alternative for users who prefer or are required to use Windows environments.

Create Pull Request

Scan History

Date	Scan	Status	Result
2026-01-14 00:00	#250	in_progress	Biased
2026-01-13 00:00	#246	completed	Biased
2026-01-11 00:00	#240	completed	Biased
2026-01-10 00:00	#237	completed	Biased
2026-01-09 00:34	#234	completed	Biased
2026-01-08 00:53	#231	completed	Biased
2026-01-06 18:15	#225	cancelled	Clean
2025-08-22 00:01	#88	completed	Clean
2025-07-22 00:01	#57	completed	Clean
2025-07-13 21:37	#48	completed	Clean
2025-07-12 23:44	#41	cancelled	Biased

Flagged Code Snippets

Add-Content -Path manifest.json -Value '[{"resourceAppId":"00000003-0000-0000-c000-000000000000","resourceAccess":[{"id":"e1fe6dd8-ba31-4d61-89e7-88639da4683d","type":"Scope"}]}]'

$region_code="WEEU"

$env:TF_VAR_app_registration_app_id = (az ad app create `
    --display-name $region_code-webapp-registration     `
    --required-resource-accesses ./manifest.json        `
    --query "appId").Replace('"',"")

$env:TF_VAR_webapp_client_secret=(az ad app credential reset `
    --id $env:TF_VAR_app_registration_app_id --append            `
    --query "password").Replace('"',"")

$env:TF_VAR_use_webapp="true"

del manifest.json