Detected Bias Types
Windows First
Powershell Heavy
Missing Linux Example
Summary
The documentation page displays a mild Windows bias in the environment variable setup section, where Windows CMD and PowerShell examples are given first and in more detail, while Linux/macOS equivalents are provided later and less prominently. The use of setx (Windows-specific) is described with restart instructions, whereas the Linux/macOS export command is listed without such context. Other sections, such as code editing and build/test commands, are cross-platform and neutral.
Recommendations
- Present environment variable setup instructions for Windows, Linux, and macOS in parallel tabbed sections, giving equal prominence and detail to each.
- Clarify restart requirements for environment variable changes on all platforms, not just Windows.
- Avoid listing Windows commands first; alternate or use tabs to prevent perceived priority.
- Include explicit Linux/macOS shell examples for all CLI steps where applicable.
- Mention that Azure CLI works on all platforms, and provide troubleshooting tips for common platform-specific issues.