Bias Analysis
Detected Bias Types
powershell_heavy
windows_tools
windows_first
missing_linux_example
Summary
The documentation page demonstrates a notable Windows bias. PowerShell is used extensively for examples and instructions, with Windows-specific cmdlets (e.g., Get-AzVmss, Remove-ServiceFabricNodeState) featured prominently and often before CLI or cross-platform alternatives. While Azure CLI and sfctl (cross-platform tools) are included, PowerShell examples are more detailed and appear first in several sections. There are no explicit Linux shell (bash) or macOS-specific examples, and no mention of Linux-specific considerations or troubleshooting. The documentation assumes familiarity with Windows tools and patterns, which may create friction for Linux/macOS users.
Recommendations
- Provide bash shell equivalents for all PowerShell examples, especially for tasks like listing nodes, scaling sets, and removing node state.
- Ensure Azure CLI and sfctl examples are as detailed and comprehensive as PowerShell ones, including error handling and step-by-step logic.
- Explicitly mention that all Azure CLI and sfctl commands work on Linux/macOS, and clarify any OS-specific differences or limitations.
- Reorder examples so that cross-platform tools (Azure CLI, sfctl) appear before or alongside PowerShell, not after.
- Add troubleshooting notes or tips for Linux/macOS environments, such as common permission issues or environment setup steps.
Create Pull Request