Bias Analysis
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 towards 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 requires installation of a PowerShell module, and there is no mention of cross-platform alternatives. The REST API is always demonstrated via PowerShell, not via curl or other tools. This creates friction for Linux/macOS users, who may not have access to PowerShell or prefer native tools.
Recommendations
- Add Bash/curl examples for REST API calls alongside PowerShell examples.
- Mention Azure CLI commands if available for triggering backups and tracking progress.
- Clarify whether the Microsoft.ServiceFabric.Powershell.Http module is available cross-platform (PowerShell Core), and if not, provide alternatives.
- Provide guidance for connecting to Service Fabric clusters from Linux/macOS (e.g., using REST API directly, Azure CLI, or other tools).
- Reorder examples so that REST API usage (which is platform-neutral) is shown first, followed by platform-specific tooling.
Create Pull Request