Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates Windows bias primarily in the 'Set environment variables' section, where Windows PowerShell is mentioned first and given as the only explicit example for setting environment variables, while Linux/bash examples are provided only for subsequent variables and not for the initial example. There is no explicit Linux or macOS equivalent for referencing environment variables, and the initial guidance is tailored to Windows users. The rest of the page uses Azure CLI and bash syntax, which is cross-platform, but the initial orientation and examples favor Windows.
Recommendations
- Provide Linux/macOS equivalents alongside Windows PowerShell examples when discussing environment variable setting and referencing.
- Present both Windows and Linux/macOS examples in parallel, or use a tabbed interface to allow users to select their platform.
- Avoid presenting Windows examples first or exclusively; ensure parity by alternating or combining examples for all major platforms.
- Explicitly state that Azure CLI commands work on Windows, Linux, and macOS, and clarify any platform-specific nuances.
- Include notes or tips for macOS users where applicable, especially for environment variable syntax and shell differences.
Create Pull Request