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 instructions for setting environment variables on Windows (cmd and PowerShell) before mentioning Linux/macOS equivalents. Windows command prompt and PowerShell commands are listed first, and PowerShell is given its own example, which may suggest a Windows-centric approach. However, Linux/macOS instructions are present and correct, and the rest of the guide uses cross-platform Go and Bash commands.
Recommendations:
- Present Linux/macOS and Windows instructions in parallel tabs or side-by-side, rather than always listing Windows first.
- Avoid giving Windows (cmd/PowerShell) instructions priority over Linux/macOS, especially for Go developers who may be more likely to use Linux/macOS.
- Consider using tabbed code blocks for 'Set environment variable' steps, with clear labels for each OS/shell.
- Where possible, use cross-platform commands (e.g., Bash) as the default, with Windows-specific instructions as alternatives.
- Ensure parity in detail and clarity between Windows and Linux/macOS instructions.
Create pull request