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 cmdlets (e.g., New-ServiceFabricService, Update-ServiceFabricService), with no equivalent Bash, CLI, or Linux-native examples. Windows/PowerShell tooling is referenced exclusively and before any cross-platform alternatives, and there is no mention of how to perform these tasks on Linux or macOS clusters. This creates friction for non-Windows users and may prevent them from easily following the instructions.
Recommendations
- Provide equivalent Azure CLI examples for all PowerShell commands, as Azure CLI is cross-platform.
- Include Bash script examples or instructions for Linux environments where appropriate.
- Explicitly state whether the described PowerShell cmdlets are available on Linux/macOS, or provide alternatives.
- Add a section clarifying platform support and differences in tooling between Windows and Linux clusters.
- Reference Service Fabric REST APIs for cluster management tasks, which are platform-agnostic.
Create Pull Request