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
⚠️ missing_linux_example
Summary:
The documentation exhibits several forms of Windows bias. Visual Studio (Windows-only) is presented as the primary IDE, with detailed, screenshot-rich steps for both .NET 8.0 and .NET Framework 4.8. PowerShell is given its own section, and PowerShell-based deployment steps are provided in detail, but Linux shell equivalents are not always present or are less detailed. In the PowerShell section, Linux deployment is explicitly discouraged, and the only provided publish steps use Windows-style paths and tools (e.g., Compress-Archive). Some CLI steps use Windows-centric commands and directory structures. Visual Studio for Mac is only mentioned in a table, with no corresponding walkthrough. There are also places where Windows is the default or first-mentioned OS, and Linux options are secondary or omitted.
Recommendations:
  • Provide parity for Linux users by including detailed, step-by-step instructions for Linux shell (bash) alongside PowerShell, especially for tasks like zipping and deploying files.
  • Include screenshots and walkthroughs for Visual Studio Code and command-line workflows on Linux, not just Windows.
  • Where PowerShell is used, offer equivalent bash/zsh commands and note any platform-specific differences.
  • Avoid language that discourages Linux use (e.g., 'We recommend Azure PowerShell for creating apps on the Windows hosting platform. To create apps on Linux, use a different tool...'). Instead, provide clear, supported Linux workflows.
  • Add explicit Visual Studio for Mac instructions or clarify its limitations.
  • Ensure all file paths and command examples are shown in both Windows and Linux formats where relevant.
  • When listing OS options (e.g., in Azure portal or CLI), present Linux and Windows equally, not always with Windows first.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-09-10 00:00 #107 completed ✅ Clean
2025-08-17 00:01 #83 in_progress ❌ Biased
2025-07-13 21:37 #48 completed ❌ Biased
2025-07-09 13:09 #3 cancelled ✅ Clean
2025-07-08 04:23 #2 cancelled ❌ Biased

Flagged Code Snippets

Connect-AzAccount
New-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -Location westeurope
New-AzResourceGroup -Name myResourceGroup -Location westeurope New-AzAppServicePlan -ResourceGroupName myResourceGroup -Name myAppServicePlan -Location westeurope -Linux New-AzWebApp -ResourceGroupName myResourceGroup -AppServicePlan myAppServicePlan -Name <app-name> Set-AzWebApp -
cd bin\Release\net8.0\publish Compress-Archive -Path * -DestinationPath deploy.zip
cd bin\Release\net8.0\publish Compress-Archive -Path * -DestinationPath deploy.zip -Force
Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force