Document Details
Service Fabric Understand And Troubleshoot With System Health Reports
This page contains Windows bias
About This Page
This page is part of the Azure documentation. It contains code examples and configuration instructions for working with Azure services.
Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias. All command-line examples use PowerShell syntax and Windows-style paths (e.g., 'PS C:\>'), with no mention of Linux or macOS equivalents. There is no reference to Service Fabric CLI (sfctl), Bash, or cross-platform tools. The only instructions for clearing health reports and querying cluster/application/service/partition/replica health are given as PowerShell cmdlets, and links to further instructions also point to Windows/PowerShell-specific documentation. This creates friction for Linux/macOS users and may prevent them from easily following the troubleshooting steps.
Recommendations
- Add equivalent examples using sfctl (Service Fabric CLI), which is cross-platform and works on Linux/macOS.
- Explicitly mention that all PowerShell commands can be run on Windows, and provide Bash/sfctl alternatives for Linux/macOS.
- Where possible, use generic API references (e.g., REST API, .NET SDK) and show how to invoke them from different platforms.
- Reorder examples so that cross-platform tools (sfctl, REST API) are shown first or alongside PowerShell.
- Update links to include Linux/macOS documentation and troubleshooting guides.
Create Pull Request
Clean