Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page demonstrates a Windows bias by referencing Windows-specific tools and patterns first (e.g., 'cmd', 'PowerShell', registry queries), providing commands and instructions that are tailored to Windows environments, and omitting equivalent Linux examples for key steps such as checking .NET installation. The use of Windows registry queries and the lack of explicit Linux alternatives for environment setup and verification further reinforce this bias.
Recommendations
- Provide Linux-specific instructions and examples alongside Windows ones, especially for prerequisite checks (e.g., use 'dotnet --list-sdks' or 'which dotnet' for .NET verification on Linux).
- Avoid referencing Windows tools (such as registry queries) exclusively; offer cross-platform alternatives.
- Explicitly mention and show examples for Bash and other Linux shells when discussing terminal commands.
- Clarify that environment variable setup and usage may differ between Windows (cmd/PowerShell) and Linux (bash/zsh), and provide sample commands for both.
- Ensure screenshots and navigation instructions in the Azure portal are not OS-specific unless necessary.
- Where possible, use generic, cross-platform terminology (e.g., 'terminal' instead of 'command window') and provide parity in all code and setup examples.
Create Pull Request