Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a notable Windows bias by consistently referencing PowerShell cmdlets and Windows-centric tools for Service Fabric management tasks. While REST API and .NET methods are mentioned, PowerShell examples are given for almost every operation, with no explicit Linux or cross-platform CLI (sfctl, Azure CLI) usage shown in examples or step-by-step instructions. The PowerShell cmdlets are often listed before REST or .NET alternatives, and there are no bash, Linux shell, or macOS-specific instructions or examples. This creates friction for Linux/macOS users, who must infer or seek out equivalent commands.
Recommendations
- Add explicit examples using sfctl (Service Fabric CLI) and Azure CLI for all major lifecycle operations (deploy, upgrade, remove, test, etc.), alongside PowerShell.
- Where PowerShell cmdlets are referenced, provide the Linux/macOS equivalent command immediately after or in parallel, not just as a footnote.
- Include bash or shell script snippets for common tasks, especially in sections about automation and cleanup.
- Clearly indicate which tools are cross-platform and which are Windows-only, and recommend cross-platform tools for general usage.
- Reorder examples so that REST API, sfctl, and Azure CLI are shown first or equally with PowerShell, to avoid implicit prioritization of Windows tools.
Create Pull Request