Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
Summary
The documentation provides environment variable setup instructions for Windows (cmd and PowerShell) before Linux/macOS (bash), and includes explicit PowerShell and Windows command prompt examples. While Linux/macOS instructions are present, Windows tooling and patterns are mentioned first, and Windows command-line examples are more detailed (e.g., restart prompt note). There are no Linux-specific tools or patterns highlighted, and the overall flow assumes familiarity with Windows environments.
Recommendations
- Present Linux/macOS and Windows instructions in parallel or start with Linux/macOS to avoid implicit prioritization.
- Add notes about differences in environment variable persistence between shells (e.g., setx vs export), and clarify that Linux/macOS changes are session-scoped unless added to shell profiles.
- Include Linux/macOS-specific troubleshooting tips or common patterns (e.g., using systemd for environment variables, or .env files).
- Ensure that all command examples (curl, Maven, etc.) are shown in both Windows and Linux/macOS contexts where relevant.
- Mention cross-platform editors and tools (e.g., IntelliJ IDEA, Eclipse) alongside Visual Studio Code.
- Review images and screenshots to ensure they are not Windows-centric (e.g., Azure Portal screenshots should not show Windows-only features).
Create Pull Request