docs: fix some comments

Author: beekld

libs/server-sdk/src/data_systems/fdv2/polling_initializer.hpp

@@ -19,13 +19,11 @@ namespace launchdarkly::server_side::data_systems {
 /**
  * FDv2 polling initializer. Makes a single HTTP GET to the FDv2 polling
  * endpoint, parses the response via the FDv2 protocol state machine, and
- * returns the result. Implements IFDv2Initializer (async, one-shot).
+ * returns the result.
  *
  * Threading model:
- *   Run() is called once from the orchestrator thread. It fires the HTTP
- *   request and returns a Future that resolves when the response arrives
- *   or Close() is called.
- *   Close() may be called from any thread, concurrently with Run().
+ *   Run() should only be called once at a time.
+ *   Close() may be called concurrently with Run().
  *   This object may be safely destroyed once no call to Run() or Close()
  *   is in progress.
  */

libs/server-sdk/src/data_systems/fdv2/polling_synchronizer.hpp

@@ -23,8 +23,10 @@ namespace launchdarkly::server_side::data_systems {
  * orchestrator to reflect applied changesets without any shared state.
  *
  * Threading model:
- *   Next() may be called from any thread. Close() may be called from any
- *   thread, concurrently with Next().
+ *   Next() should only be called once at a time.
+ *   Close() may be called concurrently with Next().
+ *   This object may be safely destroyed once no call to Next() or Close()
+ *   is in progress.
  */
 class FDv2PollingSynchronizer final
     : public data_interfaces::IFDv2Synchronizer {