Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias by presenting PowerShell and Visual Studio (Windows-only tools) as primary methods for application upgrade, with their parameters described in detail and listed before the cross-platform SFCTL CLI. Examples and parameter tables are heavily focused on PowerShell and Visual Studio, with Linux/macOS equivalents (SFCTL) relegated to a later section and described less thoroughly. There are no direct Linux shell examples, and the structure implies Windows tools are the default or preferred approach.
Recommendations
- Present SFCTL (cross-platform CLI) examples and parameter tables before or alongside PowerShell/Visual Studio sections to avoid implying Windows-first workflows.
- Include explicit Linux/macOS shell command examples for SFCTL, demonstrating parity with PowerShell workflows.
- Add a summary table comparing PowerShell, Visual Studio, and SFCTL parameters to clarify cross-platform equivalence.
- Reference Linux/macOS upgrade workflows in introductory sections, not only in 'Next steps'.
- Clarify that PowerShell and Visual Studio are Windows-only, and SFCTL is recommended for Linux/macOS users.
Create Pull Request