Detected Bias Types
Windows First
Powershell Heavy
🔧
Windows Tools
Missing Linux Example
Summary
The documentation covers both Windows and Linux usage of Azure Service Fabric, but exhibits several Windows biases. Windows-specific tools (PowerShell, Visual Studio) and terminology (Windows service, FabricHost.exe) are mentioned first or exclusively in key sections. Examples and instructions often default to Windows, with Linux equivalents referenced later or omitted. Standalone cluster creation and upgrades are described only for Windows, with Linux support explicitly stated as unavailable. Some CLI and REST API options are mentioned, but PowerShell is emphasized. Visual Studio is referenced for cluster creation, but no Linux-native tooling is suggested.
Recommendations
- Provide Linux-specific examples and instructions alongside Windows ones, especially for cluster creation, upgrades, and management.
- Mention Linux CLI tools (e.g., sfctl) and Bash scripts before or alongside PowerShell, and clarify their parity.
- Include references to Linux-native development environments (e.g., VS Code, JetBrains Rider) where Visual Studio is mentioned.
- Clearly indicate which features are Windows-only and which are cross-platform, linking to the Linux/Windows differences page.
- Add guidance for Linux users on monitoring, diagnostics, and health reporting using Linux tools.
- Update 'Next steps' to include Linux cluster creation and management, or clarify Linux limitations.