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
Summary:
The documentation demonstrates a bias toward Windows by referencing Visual Studio and its NuGet package manager as the primary method for installing packages, with CLI instructions only mentioned secondarily. There are no explicit Linux or cross-platform development environment examples (e.g., VS Code, JetBrains Rider, or command-line editors), and no Linux-specific deployment or configuration steps are provided. The workflow assumes a GUI-based, Windows-centric development pattern, with no mention of Linux shell commands or tools.
Recommendations:
- Provide explicit Linux and cross-platform instructions for package installation (e.g., using dotnet CLI and NuGet CLI) before or alongside Visual Studio instructions.
- Include examples and screenshots for Linux-based development environments, such as VS Code or JetBrains Rider, and mention command-line editors (vim, nano) for file editing.
- Add Linux-specific deployment steps, such as using Azure CLI from a Bash shell, and clarify that all steps can be performed on Linux as well as Windows.
- Avoid assuming the use of Visual Studio or right-click context menus; describe file creation and editing in a way that is editor-agnostic.
- Explicitly state that the instructions are cross-platform and highlight any differences or prerequisites for Linux users.
Create pull request