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 a moderate Windows bias. Visual Studio (Windows-only) is presented as the primary IDE in several sections, and PowerShell is given a dedicated section with detailed steps, while Linux-specific command-line or shell examples are less emphasized. In the PowerShell section, Linux deployment is explicitly deferred to other tools, and the file path and compression commands (e.g., Compress-Archive, cd bin\Release\net8.0\publish) are Windows-specific. There are missing or commented-out Linux PowerShell examples, and the overall structure often presents Windows tools and workflows before or instead of their Linux equivalents.
Recommendations:
  • Ensure parity by providing explicit Linux/macOS shell examples wherever Windows/PowerShell commands are given, especially for tasks like zipping files and navigating directories.
  • In PowerShell sections, include working Linux-compatible PowerShell or Bash alternatives, or clearly link to the equivalent Linux instructions.
  • Avoid language that recommends Windows tools (e.g., 'We recommend Azure PowerShell for creating apps on the Windows hosting platform') without offering equal guidance for Linux users.
  • Where possible, use cross-platform tools (like Azure CLI and .NET CLI) as the primary examples, or present them before Windows-specific tools.
  • Uncomment and complete the Linux PowerShell example, or provide a Bash/zsh example for Linux users.
  • Review screenshots and instructions to ensure they are not exclusively Windows-centric, and provide Linux/macOS visuals or notes where appropriate.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-07-12 23:44 #41 in_progress ❌ Biased
2025-07-12 00:58 #8 cancelled ✅ Clean
2025-07-10 05:06 #7 processing ✅ Clean
2025-07-09 23:22 #6 cancelled ✅ Clean

Flagged Code Snippets

mkdir dotnetcore-quickstart cd dotnetcore-quickstart azd init --template https://github.com/Azure-Samples/quickstart-deploy-aspnet-core-app-service.git azd up
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
Publish-AzWebApp -ResourceGroupName myResourceGroup -Name <app-name> -ArchivePath (Get-Item .\deploy.zip).FullName -Force