Bias Analysis
Detected Bias Types
windows_first
windows_tools
Summary
The documentation generally provides cross-platform instructions, with most shell commands shown in Bash and explicit notes for Windows users. However, there is a subtle Windows bias: Windows command shells and tools are mentioned first or as the default in several places, and some directory creation commands for Java use Windows-style (cmd) syntax. The guidance for setting environment variables also references Windows ('set') before Linux ('export'). There are no missing Linux examples, but the documentation sometimes assumes Windows as the primary environment.
Recommendations
- When referencing both Windows and Linux commands, list Linux/Bash instructions first, as Bash is more common in cross-platform and cloud environments.
- For directory creation and navigation, provide both Bash and Windows (cmd.exe) command blocks, or clarify which is being used in each code block.
- When mentioning environment variable setting, give equal prominence to both 'export' (Linux/macOS) and 'set' (Windows), or provide a table showing both.
- Where possible, use neutral, platform-agnostic language (e.g., 'command shell' instead of 'Windows command shell'), and clarify that all steps are supported on both platforms.
- Add explicit notes or tabs for PowerShell if relevant, or clarify that Azure CLI commands work identically on all platforms.
Create Pull Request