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.
Create pull request
Flagged Code Snippets
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