Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation provides both Windows and Linux/macOS examples for environment variable setting and role assignment, but Windows examples (including PowerShell) are presented first and with more detailed notes (such as quoting requirements). There is a link to a PowerShell-specific service principal guide in 'Related content', but no equivalent Bash or Linux shell guide. The documentation references Windows-specific patterns (e.g., SET, double quotes) before Linux equivalents, and PowerShell is given its own tab, suggesting a slight prioritization of Windows tooling and workflows.
Recommendations
- Alternate the order of Windows and Linux/macOS examples, or present Linux/macOS first to balance visibility.
- Add links to Linux/Bash-specific guides for service principal creation and Azure CLI usage in 'Related content'.
- Ensure all notes (such as quoting requirements) are provided for both Windows and Linux/macOS where relevant.
- Consider merging Windows and Linux/macOS instructions when the commands are nearly identical, highlighting only the differences.
- Add explicit mention that all CLI commands work cross-platform unless otherwise noted, to reinforce parity.
Create Pull Request