Detected Bias Types
🔧
Windows Tools
Windows First
Missing Linux Example
Summary
The documentation page primarily references Windows tools and patterns (e.g., certificate stores like LocalMachine\My, Win32 CryptoAPI, CAPI2 logging, and Windows event logs) when discussing certificate management, troubleshooting, and configuration. Linux equivalents are mentioned only briefly or parenthetically, and there are no concrete Linux/macOS-specific troubleshooting steps or examples. Windows terminology and APIs are presented first and in detail, while Linux is referenced as an aside (e.g., 'or the Linux equivalent path, /var/lib/sfcerts').
Recommendations
- Provide explicit Linux/macOS examples for certificate storage, retrieval, and troubleshooting (e.g., using OpenSSL, viewing logs, certificate file locations).
- Document Linux/macOS-specific paths, commands, and log locations alongside Windows examples, not just as parentheticals.
- Include troubleshooting steps for Linux clusters, such as how to check certificate permissions, validate certificate chains, and interpret relevant logs.
- Clarify which APIs or behaviors are platform-specific (e.g., Win32 CryptoAPI, CAPI2 logging) and offer Linux/macOS alternatives where possible.
- Add a table or section summarizing differences and equivalents between Windows and Linux certificate management in Service Fabric.