Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides both PowerShell and Azure CLI examples for creating service principals, but PowerShell is presented first and in more detail. The PowerShell example assumes use of the Az module, which is most commonly used on Windows, and references Visual Studio Code, a tool often associated with Windows workflows. There is no explicit mention of Linux or bash environments, nor are there instructions for running these commands on Linux or macOS. The CLI example uses bash syntax but does not clarify cross-platform compatibility or provide Linux-specific guidance.
Recommendations
- Alternate the order of PowerShell and CLI examples, or present CLI examples first to avoid implicit Windows prioritization.
- Explicitly state that Azure CLI commands work on Linux, macOS, and Windows, and provide example environments.
- Add notes or sections for Linux/macOS users, including any prerequisites or differences in command usage.
- Reference common Linux tools (e.g., terminal, bash) and provide guidance for running scripts in those environments.
- Avoid assuming Visual Studio Code as the default environment, or clarify its cross-platform availability.
Create Pull Request