Detected Bias Types
🔧
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation covers both Kestrel (cross-platform) and HTTP.sys (Windows-only) web servers for ASP.NET Core integration with Azure Service Fabric. However, Windows-specific tools and patterns (HTTP.sys, netsh, Windows HTTP Server API) are described in detail, often before their Linux equivalents. The HTTP.sys section is Windows-only, and while Kestrel is recommended for Linux, explicit Linux examples, troubleshooting, or environment-specific guidance are missing. Windows-centric configuration steps (e.g., netsh, ServiceManifest.xml for HTTP.sys) are presented without Linux alternatives or clarifications.
Recommendations
- Add explicit Linux/macOS guidance and examples for Service Fabric Reliable Services with Kestrel, including environment setup, deployment, and troubleshooting.
- Clearly indicate which sections are Windows-only and which are cross-platform, especially in configuration instructions.
- Provide Linux-specific notes for ServiceManifest.xml endpoint configuration and port management.
- Include sample code snippets or references for running Service Fabric Reliable Services on Linux, such as using Kestrel with Linux container images or Service Fabric clusters.
- Mention any limitations or differences for Linux users (e.g., debugging, certificate management, firewall configuration) and link to relevant documentation.