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 Windows bias by referencing Visual Studio and its NuGet package manager as the primary method for installing packages, and by using Windows-centric UI actions (e.g., right-clicking in Solution Explorer) without providing equivalent Linux or cross-platform instructions. While CLI alternatives are mentioned for NuGet, there are no explicit Linux or cross-platform development environment examples, nor is there guidance for using common Linux editors or deployment workflows.
Recommendations:
- Provide explicit Linux and cross-platform instructions for all steps, including file creation and editing (e.g., using VS Code, nano, or command-line tools).
- List CLI-based package installation (e.g., dotnet CLI) before or alongside Visual Studio/NuGet Manager instructions.
- Include deployment instructions using Azure CLI and/or GitHub Actions, not just portal-based workflows.
- Avoid assuming Visual Studio or Windows-specific workflows; clarify that any editor or OS can be used.
- Show environment variable setup using both Azure Portal and CLI (az command), and mention how to set secrets locally on Linux/macOS.
- Add a note or section for Linux/macOS users, highlighting any differences or additional steps.
Create pull request