Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
windows_tools
missing_linux_example
Summary
The documentation page demonstrates a Windows bias by presenting PowerShell-based deployment instructions first and in greater detail, with no equivalent Linux/macOS shell or script examples for the PowerShell commands. The CLI (sfctl) section is present but comes after the PowerShell examples, and the documentation refers to Windows-specific features (e.g., 'Isolation (only for Windows)'). There is no mention of Linux/macOS-specific guidance, nor are there bash or shell script equivalents for the PowerShell commands.
Recommendations
- Provide Linux/macOS shell (bash/zsh) equivalents for all PowerShell commands, especially for deployment, status checks, upgrades, and rollbacks.
- Present CLI (sfctl) instructions before or alongside PowerShell examples to avoid Windows-first ordering.
- Explicitly mention platform compatibility for each tool and command, clarifying which steps work on Linux/macOS.
- Add notes or sections for Linux/macOS users, including any prerequisites or differences in setup.
- Where Windows-only features are mentioned (e.g., Isolation), clarify alternatives or limitations for Linux/macOS.
Create Pull Request