Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides PowerShell and Azure CLI examples for creating service principals, but the PowerShell example is presented first and assumes familiarity with Windows-centric tooling. The CLI example uses Bash syntax but does not clarify Linux/macOS compatibility or provide explicit Linux/macOS instructions. There are no references to Linux-specific tools or shell environments, and the documentation does not address potential differences in running CLI commands on Linux/macOS versus Windows.
Recommendations
- Explicitly state that Azure CLI commands work on Linux/macOS and provide example commands in a Linux shell context (e.g., bash, zsh).
- Add notes or sections clarifying any differences in command usage or prerequisites for Linux/macOS users.
- Provide Linux/macOS-specific instructions for installing and using the Azure CLI, including authentication steps if they differ.
- Consider presenting CLI examples before PowerShell examples, or side-by-side, to avoid Windows-first bias.
- Avoid language that assumes Visual Studio Code or PowerShell as the default environment; mention alternatives for Linux/macOS users.
Create Pull Request