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
⚠️
missing_linux_example
⚠️
windows_tools
Summary:
The documentation demonstrates a Windows bias by prioritizing Windows-specific tools and workflows. Package installation instructions are given for the .NET Core CLI (cross-platform) and then for the Visual Studio Package Manager Console, which is Windows-only and uses PowerShell syntax. There are no explicit Linux or macOS-specific instructions, nor is there mention of Linux-native editors or workflows. The documentation assumes Visual Studio and Windows-centric tools as the default development environment.
Recommendations:
- Add explicit instructions for Linux and macOS users, such as using VS Code or JetBrains Rider as alternatives to Visual Studio.
- Clarify that the .NET Core CLI commands work on Windows, Linux, and macOS, and consider listing them first.
- Provide terminal commands for installing packages using the .NET CLI as the primary method, and mention Visual Studio/PowerShell as an alternative.
- Include notes about file paths and environment differences (e.g., appsettings.json location, directory separators) between Windows and Linux/macOS.
- Avoid assuming Visual Studio as the default IDE; mention cross-platform editors and workflows.
- Where UI navigation is described (e.g., in Azure portal), clarify that these steps are platform-agnostic.
Create pull request