Detected Bias Types
Powershell Heavy
Windows First
Missing Linux Example
Summary
The documentation page for on-demand backup in Azure Service Fabric is heavily biased toward Windows/PowerShell usage. All code examples use PowerShell, including REST API calls, and there are no examples or guidance for Linux/macOS users (e.g., Bash, curl, or Azure CLI). The prerequisite section mandates installation of a PowerShell module, and the workflow assumes PowerShell as the primary tool, creating friction for non-Windows users.
Recommendations
- Add equivalent Bash/curl examples for REST API calls, so Linux/macOS users can trigger backups and track progress without PowerShell.
- Mention Azure CLI commands if available for backup/restore operations.
- Clarify whether the Microsoft.ServiceFabric.Powershell.Http module is required only for PowerShell users, and provide alternative instructions for Linux/macOS environments.
- Reorganize examples so that REST API usage is shown independently of PowerShell, and provide cross-platform guidance.
- Explicitly state platform requirements and limitations, if any, for Service Fabric backup/restore operations.