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
⚠️
windows_tools
Summary:
The documentation provides environment variable setup instructions for Windows (cmd and PowerShell) before Linux/macOS, and includes Windows-specific tools (setx, PowerShell syntax) with detailed steps. Linux/macOS instructions are present but consistently listed after Windows, and there are no Linux-specific troubleshooting or parity notes. The CLI example (az login) is cross-platform, but the overall pattern prioritizes Windows users.
Recommendations:
- Alternate the order of platform-specific instructions so that Linux/macOS examples are sometimes listed first, or present all platform instructions in a single table for parity.
- Provide equal detail for Linux/macOS shell environments (e.g., mention ~/.bashrc or ~/.zshrc for persistent environment variables, not just export).
- Avoid using Windows-only tools (like setx) without mentioning Linux/macOS equivalents (e.g., export plus adding to shell profile).
- Where possible, use cross-platform commands or highlight them as such.
- Add troubleshooting notes for both Windows and Linux/macOS environments to ensure parity.
Create pull request