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
⚠️
windows_tools
⚠️
missing_linux_example
Summary:
The documentation exhibits a Windows bias by referencing Visual Studio and NuGet Package Manager (GUI) as the primary development environment and package management approach, with no mention of Linux-compatible tools or workflows. The service principal creation step links to a PowerShell-based guide, and there are no examples or instructions for Linux users (e.g., using .NET CLI, VS Code, or Bash).
Recommendations:
- Add instructions for creating a service principal using Azure CLI (az), which is cross-platform, alongside or instead of PowerShell.
- Include steps for installing NuGet packages using the .NET CLI (dotnet add package ...) for users on Linux or macOS.
- Reference cross-platform editors such as Visual Studio Code, and clarify that the .NET SDK and libraries work on Linux and macOS as well as Windows.
- Provide links to Linux/macOS setup guides for .NET development.
- Ensure that all tooling and workflow steps are presented in a platform-neutral way, or provide parallel instructions for both Windows and Linux users.
Create pull request