Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation shows some Windows bias, particularly in the ordering and selection of shell examples. In the Java section, command examples are provided for Bash, PowerShell, and Cmd, with Bash not always listed first. PowerShell and Cmd (Windows-specific shells) are given equal prominence to Bash, and in some cases, PowerShell is listed before Bash. There are also references to 'command prompt' and 'PowerShell' throughout, and no explicit Linux-specific instructions or troubleshooting. The use of Windows-style paths (e.g., _\src\main\java\com\fabrikam_) in Java examples further reinforces the bias. There are no explicit Linux/Mac-specific troubleshooting notes or guidance, and no mention of common Linux tools beyond jq and Azure CLI.
Recommendations
- Ensure Bash (Linux/macOS) examples are always listed first, with PowerShell and Cmd clearly marked as Windows-only.
- Where file paths are shown, provide both Windows (\) and POSIX (/) path examples, or use POSIX paths by default.
- Add explicit notes or troubleshooting for Linux/macOS users, especially around environment variables, permissions, and common issues.
- Review all references to 'command prompt' and clarify when it means Windows Command Prompt versus a generic terminal.
- Where possible, provide parity in shell scripting examples (e.g., Bash scripts for Linux/macOS, PowerShell for Windows) and highlight cross-platform commands.
- Mention Linux tools and patterns (e.g., use of export for environment variables, common text editors) where relevant.
Create Pull Request