Detected Bias Types
Windows First
🔧
Windows Tools
Missing Linux Example
Summary
The documentation is largely OS-neutral in its conceptual explanations, but when it comes to practical details, there is a notable Windows bias. Windows-specific certificate store paths and troubleshooting tools (e.g., LocalMachine\My, CAPI2 logging, Win32 CryptoAPI references) are mentioned first or exclusively, with Linux equivalents only briefly referenced or omitted. Troubleshooting and operational guidance focus on Windows event logs and tools, with little to no Linux-specific instructions or examples.
Recommendations
- For every mention of Windows certificate store paths (e.g., LocalMachine\My), provide the Linux equivalent (e.g., /var/lib/sfcerts) consistently and with equal prominence.
- Include Linux-specific troubleshooting steps, such as where to find Service Fabric logs on Linux nodes, and how to diagnose certificate issues using Linux-native tools (e.g., openssl, journalctl, or SF log locations).
- When referencing Windows tools like CAPI2 logging or Win32 CryptoAPI, add Linux alternatives or clarify which steps are Windows-only and provide Linux guidance where possible.
- In code/configuration examples, ensure both Windows and Linux paths/formats are shown side-by-side, especially for certificate loading and management.
- Explicitly mention any differences in certificate handling or requirements between Windows and Linux clusters, if applicable.