Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
missing_linux_example
windows_first
Summary
The documentation page demonstrates a Windows bias in several ways: PowerShell commands are used exclusively for manual scaling operations, with no equivalent Linux shell or cross-platform CLI examples provided. Windows-centric tools and patterns (such as PowerShell cmdlets like Disable-ServiceFabricNode and Remove-ServiceFabricNodeState) are referenced without mention of Linux alternatives. The step-by-step instructions for scaling in and out begin with PowerShell commands, and there is no guidance for users managing Service Fabric clusters from Linux environments. While links to Linux cluster creation are present in 'Next steps', the operational guidance throughout the page is Windows-first and omits Linux parity.
Recommendations
- Provide equivalent Linux shell (bash) or Azure CLI examples for all PowerShell commands, especially for node management and scaling operations.
- Explicitly mention cross-platform tools and workflows where possible, and clarify which commands are OS-specific.
- Include guidance or references for managing Service Fabric clusters from Linux environments, such as using Azure CLI, REST API, or Service Fabric SDK for Linux.
- Balance the order of examples and instructions so that Linux and Windows approaches are presented equally, or clarify when an example is Windows-specific.
- Add a table or section summarizing available management tools for both Windows and Linux, including PowerShell, Azure CLI, REST API, and Service Fabric Explorer.
Create Pull Request