Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
windows_tools
Summary
The documentation page exhibits a notable Windows bias: all setup, deployment, and health-check examples rely on Windows-specific tools (Visual Studio, PowerShell, Local Cluster Manager in the notification area). There are no Linux/macOS equivalents or instructions, and the examples and screenshots exclusively reference Windows environments and workflows. This creates friction for non-Windows users, who must find alternative tools and approaches not documented here.
Recommendations
- Add instructions for setting up a local Service Fabric dev cluster on Linux/macOS, including required tools and commands.
- Provide deployment and health-check examples using cross-platform tools (e.g., Azure CLI, REST API, Service Fabric CLI (sfctl)), and show how to use them on Linux/macOS.
- Include Linux/macOS-specific prerequisites (e.g., .NET SDK, VS Code, or JetBrains Rider) and alternative project creation steps.
- Show how to access Service Fabric Explorer from browsers on Linux/macOS, rather than relying on Windows notification area icons.
- Present PowerShell and Windows examples alongside Linux/macOS equivalents, or use cross-platform commands first.
Create Pull Request