Detected Bias Types
Windows First
🔧
Windows Tools
Powershell Heavy
Missing Linux Example
Summary
The documentation covers Azure Service Fabric concepts for both Windows and Linux, but there is a notable Windows bias. Windows-specific tools (e.g., PowerShell, Visual Studio) are mentioned before Linux equivalents, and Windows terminology (e.g., Windows service, FabricHost.exe) is used throughout. Examples and links for creating clusters and standalone clusters are Windows-first or Windows-only, with Linux standalone clusters explicitly unsupported. PowerShell is referenced as a primary management tool, with CLI and REST APIs mentioned but not emphasized. Linux parity is acknowledged, but Linux-specific instructions and examples are sparse or missing.
Recommendations
- Provide Linux-specific examples and instructions alongside Windows ones, especially for cluster creation, management, and health monitoring.
- Mention Linux tools (e.g., Bash, Linux CLI usage) before or equally with Windows tools like PowerShell.
- Clarify which features are Windows-only and which are cross-platform, and provide links to Linux documentation where available.
- Add explicit guidance for Linux users in sections about application lifecycle, monitoring, and diagnostics.
- Include Linux-focused quickstarts and tutorials in the 'Next steps' section.