Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
windows_tools
Summary
The documentation page presents PowerShell and Visual Studio (Windows tools) upgrade parameters first, with detailed tables and examples, while Linux/macOS equivalents (SFCTL/CLI) are described later and less prominently. Most parameter tables and examples are Windows-centric, and Linux users must scroll further to find relevant information. There are no explicit Linux/macOS command examples in the main body, and the structure implies a Windows-first workflow.
Recommendations
- Reorganize the documentation to present SFCTL (CLI) parameters and workflows alongside PowerShell/Visual Studio, or in parallel sections, rather than after all Windows tooling.
- Provide explicit Linux/macOS command-line examples (using SFCTL) in the main parameter tables, not only in a separate section.
- Clarify at the start that all features are available cross-platform, and that SFCTL is the recommended tool for Linux/macOS.
- Add a summary table mapping PowerShell/Visual Studio parameters to SFCTL equivalents for easy cross-reference.
- Ensure that Linux/macOS users are not required to refer to Windows tooling sections for parameter explanations.
Create Pull Request