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

Bias Types:
⚠️ windows_first
⚠️ powershell_heavy
⚠️ windows_tools
Summary:
The documentation provides both Bash (Linux/macOS) and Windows (PowerShell, Cmd) examples for Python virtual environment setup, and both Azure CLI and Azure PowerShell examples for Azure resource creation. However, there is a slight Windows bias: PowerShell and Cmd are given equal prominence to Bash, and PowerShell is presented as a first-class alternative to Azure CLI throughout, despite Azure CLI being cross-platform. Windows-specific tools and patterns (PowerShell, Cmd, 'py' launcher) are mentioned alongside or before Linux equivalents, and some instructions (such as using 'py' instead of 'python') are more relevant to Windows users.
Recommendations:
  • Prioritize Bash (Linux/macOS) examples before PowerShell and Cmd, as Bash is the default shell on most non-Windows systems and is also available on Windows via WSL.
  • Clearly indicate which commands are for which platforms, and consider grouping Windows-specific instructions after cross-platform or Linux-first instructions.
  • Instruct users to use 'python' instead of 'py' for virtual environment creation, as 'py' is a Windows-specific launcher.
  • Emphasize Azure CLI as the primary, cross-platform tool for resource creation, and present PowerShell as an alternative for Windows users.
  • Add explicit notes or callouts for Linux/macOS users where necessary, especially for common issues (e.g., missing 'venv' package).
  • Consider providing a single, cross-platform command block for steps that are identical across platforms, reducing fragmentation and potential confusion.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-13 21:37 #48 completed ✅ Clean
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

py -m venv .venv
.venv\scripts\activate
py -m venv .venv
.venv\scripts\activate
Connect-AzAccount
New-AzResourceGroup -Name AzureFunctionsQuickstart-rg -Location '<REGION>'
New-AzStorageAccount -ResourceGroupName AzureFunctionsQuickstart-rg -Name <STORAGE_NAME> -SkuName Standard_LRS -Location <REGION>
New-AzFunctionApp -Name <APP_NAME> -ResourceGroupName AzureFunctionsQuickstart-rg -StorageAccountName <STORAGE_NAME> -FunctionsVersion 4 -RuntimeVersion <PYTHON_VERSION> -Runtime python -Location '<REGION>'