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