Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation provides both Bash and Azure PowerShell examples for all CLI steps, but PowerShell is given equal prominence and is sometimes mentioned first. There is a notable bias in the prerequisites and instructions: Bash is required for Python, JavaScript, and Java samples, but no Windows Command Prompt (cmd.exe) or Linux-specific shell examples are provided. The documentation assumes users have access to PowerShell, which is primarily a Windows tool (though available on Linux/macOS), and does not offer native Linux/macOS alternatives for PowerShell commands. There are no explicit Linux/macOS-only instructions or troubleshooting notes, and Windows/PowerShell patterns are presented as the default or only alternative to Bash.
Recommendations
- Clearly indicate which examples are cross-platform and which are Windows-specific.
- Provide Linux/macOS-specific instructions or troubleshooting notes, especially for PowerShell commands.
- Add native Linux shell (e.g., sh, zsh) and Windows Command Prompt (cmd.exe) examples where appropriate.
- Clarify that PowerShell is available on Linux/macOS, but Bash is preferred for non-Windows platforms.
- List Bash examples first to reflect the majority of cross-platform developer usage.
- Explicitly state platform requirements for each language sample (e.g., 'Python sample requires Bash on Linux/macOS, PowerShell on Windows').
Create Pull Request