Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides both Linux and Windows examples for setting environment variables, but Windows/Powershell syntax is consistently presented alongside or immediately after Linux/bash, and PowerShell is given a dedicated section for authentication. Azure PowerShell is highlighted as a primary method for authentication, with no equivalent mention of Linux-native alternatives (e.g., bash scripting, other shells). The use of PowerShell examples and terminology may make the documentation feel Windows-centric, especially since PowerShell is not the default shell on most Linux systems.
Recommendations
- Ensure Linux/bash examples are presented first or equally alongside Windows/PowerShell examples.
- Add explicit instructions for common Linux shells (bash, zsh) and clarify PowerShell's availability on Linux.
- Provide parity for Linux-native authentication workflows, such as using bash scripts or other Linux tools.
- Clarify that Azure PowerShell is cross-platform, but also suggest alternatives for users who prefer not to install PowerShell on Linux.
- Consider adding troubleshooting steps specific to Linux environments (e.g., handling secret stores, keyrings).
Create Pull Request