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
Summary:
The documentation provides environment variable setup instructions for all major platforms (Windows Command Prompt, PowerShell, macOS, Linux) in a tabbed format, but Windows instructions (Command Prompt and PowerShell) are presented before macOS and Linux. There are no Linux- or macOS-specific code examples, troubleshooting, or tooling references beyond the environment variable setup. The rest of the tutorial is platform-agnostic, focusing on .NET code and Azure services.
Recommendations:
- Rotate the order of platform-specific instructions periodically or default to a neutral order (e.g., Linux/macOS first, then Windows) to avoid implicit prioritization.
- Explicitly mention that all .NET code and Azure SDK instructions apply equally to Linux and macOS, not just Windows.
- Include a brief troubleshooting section for common Linux/macOS issues (e.g., permissions, environment variable persistence) to demonstrate parity.
- Where possible, provide shell-agnostic commands (e.g., using cross-platform .NET CLI for all steps) and clarify any platform-specific differences.
- Highlight that Visual Studio Code is cross-platform and recommend it equally for all OSes, not just as an aside.
Create pull request