Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page exhibits several signs of Windows bias. Windows-specific instructions (such as PowerShell commands and references to Windows command prompt) are presented alongside or before Linux/macOS equivalents. The use of PowerShell for script permissions is emphasized, while Linux/macOS instructions are limited to a simple chmod command. Troubleshooting advice is focused on Windows (e.g., issues with WSL Bash), and there is a lack of parity in examples or troubleshooting steps for Linux users. The documentation also references Windows tools and patterns (e.g., pwsh, func.exe) without providing equivalent Linux details.
Recommendations
- Ensure Linux/macOS instructions are given equal prominence and detail as Windows instructions, including troubleshooting steps and tool usage.
- Provide explicit Linux/macOS examples for all commands, including alternatives to PowerShell (e.g., bash scripts, terminal commands).
- Avoid assuming Windows as the default environment; use neutral language and structure instructions so that Linux/macOS users are not secondary.
- Include troubleshooting tips for Linux/macOS environments, such as common issues with permissions, shell configuration, or dependencies.
- Reference cross-platform tools and commands (e.g., func CLI, azd) with clear notes about differences in usage or behavior across operating systems.
Create Pull Request