Bias Analysis
Detected Bias Types
powershell_heavy
windows_first
Summary
The documentation provides examples for configuring Service Fabric managed cluster node types using the Azure Portal, ARM templates, and PowerShell. PowerShell is the only CLI example provided, and it is presented as the exclusive scripting option for command-line automation. There are no examples for Linux/macOS CLI tools such as Azure CLI or Bash scripts. Additionally, PowerShell examples are given equal prominence to portal and ARM template methods, and are sometimes required for certain operations (e.g., removing primary node types), which may create friction for Linux/macOS users.
Recommendations
- Add Azure CLI examples alongside PowerShell for all command-line operations, as Azure CLI is cross-platform and widely used on Linux/macOS.
- Explicitly state when PowerShell is required due to Azure module limitations, and provide guidance for Linux/macOS users (e.g., using Azure Cloud Shell, which supports PowerShell and Bash).
- Where possible, mention Bash scripting or other cross-platform automation options.
- Review and update any sections where PowerShell is presented as the only automation option, ensuring Linux parity.
Create Pull Request