Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Summary
The documentation page demonstrates some Windows bias. Examples for creating and running Azure Functions projects are often presented with Windows-centric tools and patterns. PowerShell and CMD examples are provided alongside Bash, but Bash is not always presented first. The Maven archetype flow for Java includes explicit tabs for PowerShell and CMD, which are Windows-specific, while Bash is just one of several options. There is mention of setting JAVA_HOME, which is relevant for both platforms, but the file path example uses backslashes (\src\main\java\com\fabrikam), a Windows convention. There are no explicit Linux-specific troubleshooting notes, nor are Linux shell patterns (e.g., shebangs, environment variable export) shown. The use of 'terminal or command prompt' is ambiguous and could be clarified for cross-platform parity. The documentation does not provide explicit Linux-only examples or highlight differences for Linux users, and Windows tools/patterns (PowerShell, CMD, backslashes) are often presented before or alongside Bash.
Recommendations
- Present Bash examples before PowerShell and CMD in all code tabs, or default to Bash where possible.
- Use forward slashes in file path examples, or clarify that both Windows and Linux paths are supported.
- Explicitly mention Linux/macOS terminals in instructions, not just 'command prompt'.
- Add troubleshooting notes for Linux users, such as permissions, environment variable export, and package installation.
- Ensure all CLI commands are tested and shown in Bash, and clarify any differences for PowerShell/CMD.
- Avoid Windows-centric terminology and patterns unless necessary, and provide Linux/macOS equivalents where appropriate.