Bias Analysis
Detected Bias Types
windows_first
powershell_heavy
missing_linux_example
Summary
The documentation page demonstrates a Windows bias, particularly in the migration steps for Service Fabric nonmanaged clusters with Basic SKU load balancer and IP resources. All command-line examples use PowerShell cmdlets, with no equivalent Bash, Azure CLI, or Linux-native instructions. Windows tools and patterns (e.g., PowerShell, Windows-style paths) are referenced exclusively, and the only explicit OS reference in sample templates is a Windows template, even though an Ubuntu template is linked. The ordering of examples and instructions also places Windows/PowerShell first, with no Linux parity in procedural steps.
Recommendations
- Provide equivalent Azure CLI or Bash examples for all PowerShell commands, especially for resource deployment, node disabling, and removal steps.
- Explicitly mention support for Linux/macOS environments and clarify any OS-specific requirements or differences.
- Reference and highlight Linux sample templates (e.g., Ubuntu) with equal prominence to Windows templates.
- Avoid Windows-specific path conventions (e.g., D:\SvcFab) in generic configuration examples, or provide cross-platform alternatives.
- Where PowerShell is used, add a note or section for Linux users on how to perform the same actions using Azure CLI or REST API.
Create Pull Request