Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation generally uses Azure Portal UI instructions, which are cross-platform, but in the few places where command-line examples are given, the PowerShell/Windows example is presented before the Bash/Linux example. The PowerShell example uses 'curl.exe', which is specific to Windows, and the Bash example is only provided as a secondary tab. There are no Linux-specific tools or command-line patterns mentioned before their Windows equivalents.
Recommendations
- Present Bash/Linux examples before or alongside PowerShell/Windows examples, or default to Bash for cross-platform parity.
- Use cross-platform command-line tools (e.g., 'curl' instead of 'curl.exe') in examples.
- When providing tabbed examples, consider making Bash the default or at least equal in prominence to PowerShell.
- Explicitly mention that all portal-based instructions are OS-agnostic to reassure Linux users.
- Where relevant, add CLI (az cli) examples, which are cross-platform, to supplement or replace PowerShell-specific instructions.
Create Pull Request