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 steps, but repeatedly lists PowerShell as a required shell and gives PowerShell examples equal prominence to Bash. However, the language SDK quickstarts (Python, JavaScript, Java) explicitly require Bash and do not provide Windows/PowerShell equivalents for those steps. There is a slight Windows bias in the prerequisites, with PowerShell mentioned as required even though only Bash is needed for most SDK samples. The ordering of examples sometimes lists PowerShell before Bash, and PowerShell is referenced throughout, which may confuse Linux/macOS users. No Windows-only tools are used, and all critical steps have Bash equivalents.
Recommendations
- Clarify in prerequisites that Bash is required for Python, JavaScript, and Java samples, and PowerShell is optional for CLI steps.
- List Bash examples before PowerShell in all sections to prioritize cross-platform usage.
- Explicitly state which steps are cross-platform and which are Windows-specific.
- Remove PowerShell as a 'required shell' for SDK samples that only work in Bash.
- Consider adding macOS-specific notes or examples where relevant.
Create Pull Request