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 oriented toward Windows and Visual Studio workflows. All instructions for creating projects, managing dependencies, and authenticating are based on Visual Studio UI and PowerShell commands. There are no instructions or examples for Linux or cross-platform .NET development (e.g., using VS Code, JetBrains Rider, or the .NET CLI). The NuGet installation steps use PowerShell exclusively, and there is no mention of how to perform equivalent steps on Linux or macOS. The use of Visual Studio sign-in for authentication assumes a Windows environment.
Recommendations:
- Add parallel instructions for Linux/macOS users, including how to use the .NET CLI (e.g., 'dotnet new console', 'dotnet add package') for project creation and package management.
- Include examples for installing NuGet packages via the CLI (e.g., 'dotnet add package Azure.Messaging.ServiceBus') instead of only PowerShell.
- Describe authentication options that work cross-platform, such as using Azure CLI or environment variables for DefaultAzureCredential, not just Visual Studio sign-in.
- Mention and provide examples for alternative editors like VS Code or JetBrains Rider, and clarify that the code samples work on any OS supported by .NET.
- Where UI steps are described (e.g., creating projects), provide equivalent CLI commands for non-Windows users.
- Explicitly state that the tutorial is cross-platform and highlight any OS-specific steps or requirements.
Create pull request