Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation provides both Bash and Azure PowerShell examples for all CLI operations, but there is a notable bias toward Windows/PowerShell environments. PowerShell examples are given equal prominence to Bash, even though Bash is the default shell on Linux/macOS and required for most language samples. There are no explicit Linux/macOS-specific instructions or troubleshooting tips, and PowerShell is referenced as a prerequisite alongside Bash, which may confuse Linux/macOS users. Some commands (e.g., Python venv activation) assume Bash, but PowerShell alternatives are not shown. The overall flow and examples are slightly Windows-centric, especially in the initial setup and environment variable usage.
Recommendations
- Clarify that Bash is the default shell for Linux/macOS and PowerShell for Windows; make this explicit in the prerequisites.
- Present Bash examples before PowerShell examples to reflect the majority of cross-platform usage.
- Add Linux/macOS-specific notes for environment setup, such as activating Python venv or installing dependencies.
- Include troubleshooting tips for common Linux/macOS issues (e.g., permissions, path differences).
- Consider omitting PowerShell examples in sections where Bash is required (e.g., Python, JavaScript, Java samples), or provide equivalent Bash commands first.
- Add a table or section summarizing shell differences and which to use on each platform.
Create Pull Request