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 PowerShell is presented first and the CLI example uses syntax that is not fully cross-platform (e.g., variable assignment without 'export' for bash). There are no explicit Linux/macOS shell examples, and the PowerShell module is highlighted, which may lead Linux users to feel secondary or confused. The documentation does not mention Linux-specific considerations or tools, and the CLI example assumes familiarity with bash but does not clarify shell compatibility.
Recommendations
- Present Azure CLI (bash) examples before PowerShell, or side-by-side, to avoid Windows-first bias.
- Explicitly state that Azure CLI commands work on Linux/macOS and provide tested bash/zsh syntax (e.g., use 'export' for environment variables).
- Add a note clarifying that PowerShell is available on Linux/macOS, or provide links to installation instructions.
- Include troubleshooting or tips for Linux/macOS users, such as shell compatibility or authentication nuances.
- Avoid referencing Visual Studio Code as the only tested environment; mention alternatives or clarify cross-platform support.
Create Pull Request