update doc

Author: vegaro

purchases/src/main/kotlin/com/revenuecat/purchases/common/workflows/WorkflowsCache.kt

@@ -165,11 +165,11 @@ internal class WorkflowsCache(
         }
 
     /**
-     * Drops persisted envelopes whose workflowId is no longer in the latest list. This is the
-     * keyed-map equivalent of how [com.revenuecat.purchases.common.offerings.OfferingsCache] stays
-     * bounded by wholesale-replacing its single response blob: the persisted set always equals what
-     * the latest backend response says exists, so workflows the backend stopped sending don't
-     * linger on disk.
+     * Drops persisted envelopes whose workflowId is no longer in the latest list. Because only
+     * successfully-prefetched workflows are ever written here (see [cacheWorkflowDetailEnvelope]),
+     * this prune removes stale prefetch envelopes for workflows the backend has stopped sending.
+     * It is the keyed-map equivalent of how [com.revenuecat.purchases.common.offerings.OfferingsCache]
+     * stays bounded by wholesale-replacing its single response blob.
      */
     @Synchronized
     private fun pruneWorkflowDetailEnvelopesToList(workflowIds: Set<String>) {