Detected Bias Types
Powershell Heavy
Windows First
Summary
The documentation provides examples for modifying Service Fabric managed cluster node types using the Azure Portal, ARM templates, and PowerShell. PowerShell is the only CLI example provided, with no mention of Azure CLI or Bash equivalents. PowerShell is a Windows-centric tool, and its exclusive use creates friction for Linux/macOS users. Additionally, PowerShell examples are given for every operation (add, remove, scale, configure placement properties), and are presented alongside or after portal and ARM template methods, but never with Linux-friendly CLI options.
Recommendations
- Add Azure CLI examples for all operations (add, remove, scale, configure placement properties, etc.) to ensure Linux/macOS users have parity.
- Explicitly mention that PowerShell examples are Windows-centric and provide links or guidance for Linux/macOS users.
- Where possible, clarify if ARM template operations can be performed equally from Linux/macOS environments (e.g., using Azure CLI or REST API).
- Consider including Bash scripts or references to cross-platform tools for cluster management.