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
⚠️ missing_linux_example
⚠️ windows_tools
⚠️ powershell_heavy
Summary:
The documentation is heavily biased towards Windows and Visual Studio on Windows. All instructions and examples assume the use of Visual Studio 2022, a Windows-only IDE, and reference Windows-specific publishing targets (e.g., Azure Function App (Windows)). There are no instructions or examples for Linux users, such as using VS Code, the Azure CLI, or cross-platform .NET tools. The use of the Package Manager Console (PowerShell-based) and NuGet commands is also presented in a way that assumes a Windows environment. No Linux or cross-platform alternatives are mentioned or prioritized.
Recommendations:
  • Provide equivalent instructions for Linux users, such as using Visual Studio Code or JetBrains Rider with the Azure Functions extension.
  • Include examples using the Azure CLI and/or Azure Functions Core Tools for project creation, extension installation, and deployment, which work cross-platform.
  • Show how to install NuGet packages using the dotnet CLI (e.g., 'dotnet add package ...'), which is cross-platform, instead of only using the Package Manager Console.
  • When describing publishing, include steps for deploying from Linux/macOS using the Azure CLI or GitHub Actions.
  • Avoid specifying 'Azure Function App (Windows)' as the only deployment target; mention Linux-based hosting plans and how to select them.
  • Add a 'Prerequisites' section for Linux/macOS, listing required tools and setup steps.
  • Where possible, use neutral terminology (e.g., 'terminal' instead of 'console') and avoid assuming the reader is using Windows.
GitHub Create pull request

Scan History

Date Scan ID Status Bias Status
2025-08-17 00:01 #83 in_progress ✅ Clean
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

NuGet\Install-Package Microsoft.Azure.Functions.Worker.Extensions.OpenApi -Version 1.5.1
NuGet\Install-Package Microsoft.Azure.WebJobs.Extensions.OpenApi -Version 1.5.1